AFR — CAD 缺失字体自动替换工具
**减少缺失字体导致的文字不显示、乱码和反复手动指定字体**
[](LICENSE.txt)
[](#-已支持版本)
[](https://dotnet.microsoft.com/)
[GitHub](https://github.com/splrad/CADFontAutoReplace) · [Gitee（国内镜像）](https://gitee.com/splrad/CADFontAutoReplace) · [Releases](https://github.com/splrad/CADFontAutoReplace/releases) · [提交 Issue](https://github.com/splrad/CADFontAutoReplace/issues)
**📥 补充下载链接：[123网盘](https://1819233892.share.123pan.cn/123pan/QtB9jv-OJk7h)**
---
## ✨ 项目亮点
- **缺失字体自动替换**：AFR 会自动处理图纸中的缺失字体，避免打开图纸因为字体问题造成字符显示不全或乱码。
- **字体缺失场景全覆盖**：同时处理 SHX 主字体、SHX 大字体、TrueType 字体，以及多行文字中的内联字体缺失。
- **安装和卸载无残留**：部署工具/单DLL会自动识别 AutoCAD 2018–2027，完成安装、卸载、字体释放和插件状态检查全流程。
- **支持人工复核**：通过 `AFRLOG` 查看每个缺失字体的替换情况，并对当前图纸逐条或批量调整。
---
## 🚀 快速开始
### 推荐：部署工具一键安装
一般用户只需要下载并运行 **`AFR-Deployer_vX.Y.Z.exe`**；`AFR-DLL_vX.Y.Z.zip` 主要用于维护、测试或受限环境下的手动 `NETLOAD`。
1. 在 [Releases](https://github.com/splrad/CADFontAutoReplace/releases) 下载最新发行包。
2. **先关闭所有 AutoCAD 进程**（部署工具会在检测到 CAD 运行时禁用安装/卸载按钮）。
3. 双击运行 `AFR-Deployer_vX.Y.Z.exe`，工具会自动扫描本机已安装的 AutoCAD 版本。
4. 勾选需要安装的项目，确认“部署路径”（默认会选中首个非系统盘下的 `\CADPlugins\`），点击“安装”。
5. 工具会自动完成：
- 将对应版本 DLL 复制到部署路径；
- 在注册表写入自动加载项；
- 释放内嵌默认 SHX 字体到各 CAD 的 `Fonts` 目录；
- 写入 `FixedProfile.aws` 以抑制“缺少 SHX 文件”弹窗。
6. 启动 AutoCAD 后，插件自动生效。
> 部署工具会实时监听注册表变化：后续安装/卸载新的 CAD 版本或修改配置文件后，无需手动“刷新”，列表会自动更新。
>
> 卸载同样在部署工具中完成：勾选已安装的项目点击“卸载”，工具会同步还原注册表与 `FixedProfile.aws` 中由本插件写入的节点。
### 单 DLL 手动安装
部署工具是推荐方式；如果只需要单 DLL 场景（例如维护、测试、受限环境），可以手动 `NETLOAD`：
1. 在 [Releases](https://github.com/splrad/CADFontAutoReplace/releases) 下载 `AFR-DLL_vX.Y.Z.zip` 并解压。
2. 按 AutoCAD 版本选择对应 DLL，例如 AutoCAD 2026 使用 `AFR-ACAD2026.dll`。
3. 在 AutoCAD 命令行输入 `NETLOAD`，选择该 DLL。
4. 首次 `NETLOAD` 会完成默认字体部署、配置初始化与自动加载注册；按命令行提示重启 AutoCAD 后生效。
单 DLL 卸载时，在 CAD 命令行完整输入 `AFRUNLOAD`。该命令会卸载当前会话中的插件事件/Hook，并清理 AFR 自动加载注册表项和由插件写入的配置节点。`AFRUNLOAD` 是维护入口，不参与自动补全和动态输入建议，必须完整输入命令名。
### 首次配置与验证
1. 首次安装后启动 AutoCAD，插件会自动将内置默认字体释放到 CAD 的 `Fonts` 目录。
2. 插件会自动写入默认配置：
- SHX 主字体：`ming.shx`
- SHX 大字体：`tssdchn.shx`
- TrueType 字体：`宋体`
3. 如需修改默认配置，可在 AutoCAD 中输入 `AFR`，重新配置三类替换字体。
> 字体精简建议：
> - 建议将 CAD 安装目录 `Fonts` 中 SHX 字体精简至 100 个以内；
> - 保留 `sas_____.pfb`、`MstnFontConfig.xml`、`internat.rsc`、`font.rsc` 等非 SHX 文件；
> - 字体过多会导致插件界面加载明显卡顿。
>
> [点击下载 CAD 字体包（Fonts.zip）](https://github.com/splrad/CADFontAutoReplace/releases)
打开有缺失字体的 DWG，看到类似日志即说明插件已执行：
```text
====================================================================================
AFR 缺失字体自动替换 v9.1.0
项目地址GitHub(国外)：github.com/splrad/CADFontAutoReplace
项目地址Gitee(国内)：gitee.com/splrad/CADFontAutoReplace
命令: AFR(配置) AFRLOG(日志) AFRUNLOAD(卸载命令)
====================================================================================
[字体修复]已替换缺失字体 3 个(SHX主字体:1,SHX大字体:1,TrueType:1) | MText内联字体映射：0
```
### 手动替换
如果自动替换结果不理想：
1. 输入 `AFRLOG`
2. 查看缺失字体与当前替换目标
3. 逐条调整或使用批量填充
4. 点击“应用替换”写入当前图纸
> `AFRLOG` 每次打开都会重新读取图纸实时状态（含 `STYLE` 修改结果）。
>
> MText 内联字体采用运行时映射自动处理，不支持手动替换。
## 🖼️ 界面预览
