在使用 LightningCAD（闪电围护）的过程中，您可能会遇到各种问题。本章按照问题类别进行了系统整理，每个问题均包含现象描述、可能原因和解决方案三个部分，帮助您快速定位并解决问题。
提示：在联系技术支持之前，建议您先按照本章对应问题的解决方案进行自查，大多数常见问题均可通过简单操作自行修复。
本节涵盖 LightningCAD 安装、注册和启动过程中可能出现的问题。
现象
启动 LightningCAD 客户端后，进入"设置"页面的 CAD 管理区域为空，或显示"未检测到支持的 CAD 版本"提示。在"软件启动"页面也可能显示红色警告信息。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | CAD 未安装或安装不完整 | 计算机上尚未安装 AutoCAD 或中望CAD，或 CAD 安装过程异常中断 |
| 2 | CAD 从未启动过 | CAD 安装后未至少成功运行过一次，导致注册表中缺少必要的配置项 |
| 3 | CAD 版本不在支持范围内 | 当前仅支持 AutoCAD 2019/2020 和中望CAD 2022 及以上版本 |
| 4 | 32 位 CAD 不兼容 | LightningCAD 仅支持 64 位版本的 CAD |
| 5 | 注册表权限不足 | 当前用户无权读取 CAD 相关的注册表键值 |
解决方案
ABOUT 查看版本信息，确认显示为 64 位版本。Win + R 输入 regedit，导航到以下路径确认 CAD 注册信息存在：
HKEY_LOCAL_MACHINE\SOFTWARE\Autodesk\AutoCADHKEY_LOCAL_MACHINE\SOFTWARE\ZWSOFT\ZWCAD现象
CAD 启动后，命令行显示了插件加载成功的欢迎信息（"~欢迎使用闪电CAD~"），但 Ribbon 工具栏中未出现"闪电围护"选项卡。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | CUI 菜单文件缺失 | 插件目录下的 Lt.cuix（或中望CAD 2025+ 的 Lt_z25.cuix）文件不存在 |
| 2 | CUI 菜单未加载 | 菜单文件存在但未被 CAD 正确加载 |
| 3 | CAD 工作空间未刷新 | Ribbon 界面未刷新显示新加载的菜单 |
| 4 | 插件注册开关未开启 | 客户端中对应 CAD 版本的"自启动"开关处于关闭状态 |
解决方案
检查 CUI 文件是否存在：
AC_2019\ 或 ZW_2022\ 文件夹中是否存在 Lt.cuix。Lt_z25.cuix。手动加载 CUI 菜单：
CUILOAD 并回车。FsLtGroup。Lt.cuix（或 Lt_z25.cuix）文件并加载。刷新工作空间：
确认插件注册状态：
现象
CAD 启动后，命令行未显示 LightningCAD 的欢迎信息，或弹出错误对话框提示无法加载某个 DLL 文件。CAD 命令行可能显示类似"无法加载程序集"或"找不到指定模块"的错误。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | 插件 DLL 文件缺失或损坏 | 安装目录下的 DLL 文件不完整 |
| 2 | 受信任路径未配置 | CAD 的安全设置阻止了非信任路径下的 DLL 加载 |
| 3 | .NET Framework 版本不匹配 | 系统未安装 .NET Framework 4.8 |
| 4 | ARX/ZRX 文件加载失败 | 原生 C++ 扩展文件加载异常 |
| 5 | CAD 安全级别设置过高 | SECURELOAD 系统变量值设置为 1 或 2 |
| 6 | 杀毒软件隔离文件 | 杀毒软件将 DLL 文件误判为威胁并隔离 |
解决方案
检查文件完整性：
AC_2019\（AutoCAD）或 ZW_2022\（中望CAD）文件夹。Fs.Lt.CAD.Launcher.dll、FsCadCore.arx、FsAecBase.dbx、FsAecBaseMgd.dll、Fs.Fox.AutoCad.dll、Fs.Lt.CAD.AecEntity.dll、Fs.Lt.CAD.Common.dll、Fs.Lt.CAD.Kit.dll、Fs.Lt.CAD.Main.dllFs.Lt.CAD.Launcher.dll、FsCadCore.zrx、FsAecBase.zrx、FsAecBaseMgd.dll、Fs.Fox.ZwCad.dll、Fs.Lt.CAD.AecEntity.dll、Fs.Lt.CAD.Common.dll、Fs.Lt.CAD.Kit.dll、Fs.Lt.CAD.Main.dll重新注册插件：
调整 CAD 安全设置：
SECURELOAD，将值设为 0（允许加载任意位置的插件）。TRUSTEDPATHS 中（重新注册插件会自动配置）。检查 .NET Framework：
Win + R 输入 regedit，导航到 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full。Release 值，确认 ≥ 528040（即 .NET Framework 4.8）。检查杀毒软件隔离区：
手动加载插件：
NETLOAD 并回车。AC_2019\ 或 ZW_2022\ 文件夹，选择 Fs.Lt.CAD.Launcher.dll 并加载。现象
双击桌面快捷方式启动 LightningCAD 客户端后，窗口短暂出现后立即消失，或直接崩溃退出。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | .NET Framework 4.8 未安装或损坏 | 客户端基于 .NET Framework 4.8 构建 |
| 2 | 配置文件损坏 | 本地配置文件存在异常数据导致启动崩溃 |
| 3 | 单实例冲突 | 已有客户端实例在后台运行 |
| 4 | WebView2 Runtime 缺失 | QQ 群登录功能依赖 WebView2 运行时 |
| 5 | 系统兼容性问题 | 操作系统版本过低或不兼容 |
解决方案
检查 .NET Framework：
清理配置文件：
Win + R，输入 %AppData%\FsLt 并回车。UserProfiles 文件夹重命名为 UserProfiles_backup（备份而非删除）。检查后台进程：
Ctrl + Shift + Esc 打开任务管理器。Fs.Lt.Client.exe，如果存在，右键选择"结束任务"。安装 WebView2 Runtime：
检查操作系统版本：
Win + R 输入 winver 查看当前系统版本。查看日志文件：
%AppData%\FsLt\Logs\ 目录，查看最新的客户端日志文件 lt-client-{日期}.txt。现象
启动客户端或 CAD 插件时，弹出提示".NET Framework 版本不匹配"或"需要 .NET Framework 4.8"。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | 未安装 .NET Framework 4.8 | 系统缺少必要的运行时环境 |
| 2 | .NET Framework 安装损坏 | 已安装但文件损坏 |
| 3 | Windows 更新导致版本回退 | 系统更新后 .NET Framework 状态异常 |
解决方案
检查当前版本：
Win + R 输入 regedit，导航到：HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full
Release 的值：
安装/升级 .NET Framework 4.8：
修复已安装的 .NET Framework：
现象
安装过程中或 CAD 启动时，杀毒软件（如 360 安全卫士、腾讯电脑管家、Windows Defender 等）弹出安全警告，阻止操作或将文件隔离。
可能原因
LightningCAD 在安装过程中需要执行以下操作，可能被杀毒软件误判为可疑行为：
fsltcad://）解决方案
安装阶段：
运行阶段 — 添加白名单：
C:\Program Files\LightningCAD\（或您自定义的安装路径）%AppData%\FsLt\Fs.Lt.Client.exe恢复被隔离的文件：
Windows Defender 用户：
现象
在客户端"设置"中已开启"开机自动运行"，但重启计算机后 LightningCAD 客户端未自动启动。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | 启动项被禁用 | Windows 任务管理器中禁用了 LightningCAD 的启动项 |
| 2 | 杀毒软件拦截 | 杀毒软件阻止了开机自启动 |
| 3 | Windows 快速启动干扰 | Windows 的"快速启动"功能可能导致启动项未正常执行 |
| 4 | 注册表项缺失 | 自启动注册表项未正确写入或被清除 |
解决方案
检查任务管理器启动项：
Ctrl + Shift + Esc 打开任务管理器。检查杀毒软件：
关闭 Windows 快速启动：
重新开启自启动：
本节涵盖 LightningCAD 客户端登录、认证和账号管理相关的问题。
现象
在登录窗口输入账号密码后点击"登录"，系统提示"无法连接到服务器"或"请求失败，请检查网络连接"。标题栏的服务器状态指示灯显示为红色。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | 本地网络异常 | 计算机未连接互联网或网络连接不稳定 |
| 2 | 防火墙拦截 | 系统防火墙或企业防火墙阻止了客户端的网络访问 |
| 3 | 代理服务器配置 | 企业网络需要通过代理服务器访问外网 |
| 4 | 服务端暂时不可用 | LightningCAD 服务器正在进行维护或出现临时故障 |
| 5 | DNS 解析失败 | 无法解析服务器域名 |
解决方案
检查网络连接：
检查防火墙设置：
Fs.Lt.Client.exe 已被允许通过防火墙（包括"专用"和"公用"网络）。检查代理设置：
等待并重试：
刷新 DNS 缓存：
Win + R 输入 cmd，在命令提示符中执行：ipconfig /flushdns
现象
输入正确的邮箱和密码后，系统提示"账号或密码错误"，但您确认密码输入无误。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | 大小写或输入法问题 | 密码输入时大小写不正确或使用了中文输入法 |
| 2 | "记住账号"保存的密码已过期 | 自动填充的密码是旧密码 |
| 3 | 账号在其他设备被修改 | 密码已在其他设备上被修改但本地未同步 |
| 4 | 验证码错误 | 图形验证码输入不正确导致登录失败 |
解决方案
检查输入细节：
清除自动填充：
重置密码：
确认验证码：
0 和字母 O、数字 1 和字母 l 等）。现象
登录窗口中的图形验证码区域显示为空白、加载失败，或点击验证码图片后无法刷新。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | 网络连接异常 | 验证码图片需要从服务器获取 |
| 2 | 验证码服务暂时不可用 | 服务端验证码生成服务异常 |
| 3 | 图片加载超时 | 网络延迟导致验证码图片加载超时 |
解决方案
现象
登录成功后，使用一段时间后标题栏的服务器状态指示灯变为红色（"服务器未连接"），或操作时提示需要重新登录。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | 网络不稳定 | Wi-Fi 信号弱或网络频繁断连 |
| 2 | Token 过期 | AccessToken 已过期且 RefreshToken 刷新失败 |
| 3 | 休眠/待机唤醒 | 计算机休眠后网络连接中断 |
| 4 | 多设备登录冲突 | 同一账号在其他设备上登录导致当前设备 Token 失效 |
解决方案
检查网络稳定性：
重新登录：
检查电源设置：
确认单设备使用：
查看心跳状态：
现象
点击"QQ群登录"按钮后，弹出的 WebView2 窗口中 QQ 登录页面无法加载，或扫码完成后系统未自动跳转，提示"验证失败"。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | WebView2 Runtime 未安装 | QQ 群登录依赖 Microsoft Edge WebView2 运行时 |
| 2 | 非授权 QQ 群成员 | 您的 QQ 账号不在 LightningCAD 授权的 QQ 群中 |
| 3 | QQ 登录页面未完全加载 | 页面尚未加载完成就进行了验证操作 |
| 4 | 登录凭据不完整 | 缺少必要的 Cookie 信息（如 skey） |
| 5 | 网络环境问题 | QQ 登录页面需要访问腾讯服务器 |
解决方案
安装 WebView2 Runtime：
确认群成员身份：
等待页面完全加载：
重新登录：
检查网络：
https://qzone.qq.com）。现象
忘记了 LightningCAD 的登录密码，无法登录。
解决方案
LightningCAD 提供了内置的密码重置功能，操作步骤如下：
安全说明：密码在传输过程中采用 SM2 国密算法加密，确保通信安全。
现象
登录或使用时，系统提示"设备未授权"或"许可证无效"。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | 许可证未申请或已过期 | 未申请许可证，或许可证已超过有效期 |
| 2 | 试用期已过 | 30 天试用期已到期 |
| 3 | 硬件变更导致设备指纹变化 | 更换了计算机主要硬件（如主板、硬盘） |
| 4 | 许可证绑定其他设备 | 许可证已绑定到其他计算机 |
解决方案
申请/续期许可证：
检查试用期状态：
联系技术支持：
本节涵盖板材排布功能使用过程中可能遇到的问题。
现象
执行板材排布后，生成的板材总数量明显多于或少于预期值。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | 排布参数设置不当 | 板宽、排布方向、起铺点等参数与实际需求不匹配 |
| 2 | 围护边界不准确 | 边界线尺寸或形状与设计意图不一致 |
| 3 | 洞口未被识别 | 洞口对象未被正确选择或关联 |
| 4 | 循环排板配置问题 | 多板型循环排布时，板型列表顺序或数量配置有误 |
| 5 | 节点线分割影响 | 节点线位置导致板材被额外分割 |
解决方案
检查排布参数：
验证围护边界：
确认洞口关联：
AecRectOpeningMgd 或 AecPolyOpeningMgd）。检查循环排板设置：
利用预排板预览：
现象
排布完成后，部分板材在图纸上出现相互重叠的情况，碰撞检查报告中也标识了重叠区域。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | 多轮廓边界交叉 | 多个围护边界之间存在交叉重叠区域 |
| 2 | 排布参数冲突 | 板宽与边界尺寸不匹配，导致末端板材超出边界 |
| 3 | 搭接线补刀异常 | 搭接线分割后板材位置计算偏差 |
| 4 | 手动调整后未刷新 | 手动移动板材后未触发排布更新 |
解决方案
检查边界关系：
ZOOM 命令放大检查边界交接处。运行碰撞检查：
FsLtCollisionCheck），系统将自动检测所有重叠区域并在图纸上高亮标识。调整排布参数：
重新排布：
现象
排布生成的某些板材长度超出了板材规格的最大允许长度，或系统提示"板长超出限制"。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | 板材库中最大长度设置不合理 | 板型参数中的最大长度值未正确配置 |
| 2 | 边界跨度过大 | 围护边界的单段长度超过了板材最大允许长度 |
| 3 | 未设置搭接线 | 长墙面未添加搭接线进行分段 |
解决方案
检查板材库参数：
添加搭接线分段：
调整排布方向：
现象
排布后，洞口（门窗洞口）周围的板材未被正确裁剪，板材穿越了洞口区域，或裁剪形状不正确。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | 洞口未被选择 | 排布操作中遗漏了洞口选择步骤 |
| 2 | 洞口实体类型不匹配 | 使用的不是 LightningCAD 识别的洞口实体 |
| 3 | 洞口与边界不在同一平面 | 洞口的 Z 坐标与边界不一致 |
| 4 | 洞口位置超出边界 | 洞口未完全位于围护边界内部 |
解决方案
重新排布并选择洞口：
验证洞口实体：
AecRectOpeningMgd）或异形窗（AecPolyOpeningMgd）。检查洞口位置：
PROPERTIES 命令检查洞口和边界的 Z 坐标，确保两者一致。现象
执行排布命令后，系统弹出错误提示，如"边界不闭合"、"参数错误"、"排布失败"等，未能生成板材。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | 围护边界不闭合 | 边界多段线存在开口或断点 |
| 2 | 边界自相交 | 边界线存在自相交（蝴蝶结形）的情况 |
| 3 | 未完成单体初始化 | 未执行 FsInitBuilding 命令创建 .cfg/ 配置目录 |
| 4 | 板型参数异常 | 板宽为 0 或为负数等无效值 |
| 5 | 配置方案损坏 | 当前排布配置方案的 JSON 文件数据异常 |
解决方案
检查边界闭合性：
PEDIT 命令的"闭合"选项将其闭合。检查边界自相交：
PEDIT 命令编辑顶点，消除交叉。执行单体初始化：
FsInitBuilding 并回车。.cfg/ 配置目录。检查板型参数：
重建配置方案：
.cfg\Configs\ 目录下，您也可以手动删除对应的 .configs.json 文件后重新创建。现象
对板材执行合并操作后，板材编号出现重复、跳号或格式不统一的情况。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | 合并后未重新编号 | 合并操作保留了原板材的部分编号 |
| 2 | 手动修改编号冲突 | 手动修改了部分板材编号导致与自动编号冲突 |
| 3 | 多次排布叠加 | 在同一区域多次执行排布，新旧板材编号交叉 |
解决方案
执行自动重新编号：
FsLtPanelRenumber），对所有板材进行统一重新编号。运行编号校验：
清理多余排布：
现象
生成的板材统计表中的数量、面积或总长度等数据与图纸中实际的板材不一致。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | 统计前未更新排布 | 板材经过手动修改后未刷新统计数据 |
| 2 | 选择范围不正确 | 统计时未选中所有需要统计的板材 |
| 3 | 存在 ID 重复 | 图纸中存在实体 ID 重复的问题，导致统计遗漏或重复 |
| 4 | 归并参数设置不当 | 归并长度的容差值设置不合理 |
解决方案
刷新统计数据：
确认选择范围：
运行 ID 重复检查：
检查归并参数：
本节涵盖节点线自动生成、规则映射以及收边处理相关的问题。
现象
使用自动生成节点线功能后，生成的节点线位置偏离预期位置，或出现在不应有节点的地方。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | 规则映射配置不当 | 安装位置与节点类型的映射关系配置错误 |
| 2 | 缩进值设置不合理 | 节点线的缩进参数（IndentLeft/IndentRight）过大或过小 |
| 3 | 板材排布数据不完整 | 排布结果缺少必要的属性信息 |
| 4 | 围护边界不规则 | 边界线形状不规则导致自动计算的位置偏差 |
解决方案
检查规则映射配置：
调整缩进值：
删除并重新生成：
手动调整位置：
MOVE 命令或夹点编辑进行手动微调。现象
已配置好节点线规则映射，但执行自动生成命令后，节点线未按配置的规则创建，或某些位置完全没有生成节点线。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | 配置未保存 | 规则映射修改后未点击保存 |
| 2 | 节点图块未插入 | 图纸中未插入规则映射所引用的节点图块 |
| 3 | 前置条件不满足 | 未完成板材排布或图纸中缺少围护边界 |
| 4 | 配置文件损坏 | 规则映射的配置文件数据异常 |
解决方案
确认配置已保存：
插入节点图块：
FsJieDianKuWeiHu），将规则映射中引用的节点图块插入到图纸中。验证前置条件：
AecLayoutBoundaryMgd）。重建配置文件：
.cfg\Configs\ 目录下对应的节点线配置文件。现象
对收边执行分段操作后，各段的编号出现重复、缺失或格式混乱的情况。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | 分段参数设置不当 | 分段长度或搭接参数配置不合理 |
| 2 | 原始收边编号格式不标准 | 原始编号格式不支持自动追加段号 |
| 3 | 多次分段叠加 | 对已分段的收边再次执行分段操作 |
解决方案
检查分段参数：
规范编号格式：
SB-001），系统将在分段后自动追加段号（如 SB-001-1、SB-001-2）。撤销并重新分段：
UNDO 命令撤销分段操作。现象
导出收边 BOM 表（材料清单）到 Excel 时，部分收边件信息缺失或数据不完整。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | 收边属性信息不完整 | 部分收边图块的属性字段未填写完整 |
| 2 | 收边未正确关联节点线 | 收边与节点线的关联关系丢失 |
| 3 | 导出范围选择不当 | 导出时未选中所有需要统计的收边 |
| 4 | 收边图块数据损坏 | 个别收边图块的属性数据存在异常 |
解决方案
检查收边属性：
修复关联关系：
扩大导出范围：
检查图块完整性：
现象
原本与板材关联的节点线，在板材编辑或移动后，关联关系丢失，节点线不再跟随板材变化。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | 板材被删除后重新创建 | 删除板材后其 ID 变化，节点线的关联引用失效 |
| 2 | 手动移动板材 | 使用 CAD 原生命令移动板材，未触发关联更新 |
| 3 | 图纸复制/粘贴 | 跨图纸复制粘贴板材和节点线时，关联关系可能丢失 |
解决方案
使用 LightningCAD 命令编辑：
MOVE、COPY 等命令直接操作板材实体。重新生成节点线：
避免跨图纸操作：
本节涵盖不同 CAD 平台、版本之间的兼容性问题。
现象
在 AutoCAD 2019 中创建的图纸，在 AutoCAD 2020 中打开时出现异常，或反之。
说明
LightningCAD 的 AutoCAD 插件采用统一的 AC_2019 构建，同时兼容 AutoCAD 2019（R23.0）和 AutoCAD 2020（R23.1）。两个版本之间共享同一套插件文件，核心功能完全一致。
可能遇到的问题
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 自定义实体显示异常 | 不同版本的自定义实体渲染引擎略有差异 | 在目标版本的 CAD 中执行 REGEN 命令刷新显示 |
| CUI 菜单位置偏移 | 不同版本的 Ribbon 布局可能不同 | 切换工作空间后切回，触发 Ribbon 刷新 |
| ARX 加载警告 | 版本差异导致的安全提示 | 确认 SECURELOAD 设为 0 或插件路径已加入信任路径 |
现象
某些功能在 AutoCAD 中正常，但在中望CAD 中表现不同或不可用。
已知差异
| 功能 | AutoCAD | 中望CAD | 说明 |
|---|---|---|---|
| CUI 菜单加载方式 | Managed API（LoadPartialMenu） |
LISP 脚本动态加载 | 中望CAD 2024 及以下使用 Lt.cuix，2025+ 使用 Lt_z25.cuix |
| ARX/ZRX 文件格式 | .arx / .dbx |
.zrx |
原生扩展文件格式不同 |
| 注册表路径 | HKCU\SOFTWARE\AutoDesk\AutoCAD\... |
HKCU\SOFTWARE\ZWSOFT\ZWCAD\... |
插件注册路径完全隔离 |
| 搜索路径配置 | TRUSTEDPATHS |
ZWCADSEARCHPATH |
受信任路径的注册表键名不同 |
| 部分高级 API | 完整支持 | 部分 API 可能缺失或行为不同 | 极少数高级功能可能在中望CAD 中暂不可用 |
解决方案
确保使用正确的插件版本：
AC_2019 目录下的插件文件。ZW_2022 目录下的插件文件。中望CAD 2025+ 用户：
Lt_z25.cuix 菜单文件。Lt_z25.cuix 文件。功能差异反馈：
现象
安装了其他 CAD 插件（如天正建筑、理正等）后，LightningCAD 出现功能异常、命令无法识别或 CAD 崩溃等问题。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | DLL 加载冲突 | 多个插件引用了相同名称但不同版本的依赖库 |
| 2 | 命令名冲突 | 不同插件注册了相同的命令名 |
| 3 | Serilog 日志冲突 | 多个插件共用 Serilog 的静态 Log.Logger，导致日志配置被覆盖 |
| 4 | 图层/样式冲突 | 不同插件修改了相同的 CAD 系统变量或图层设置 |
解决方案
排查冲突插件：
调整加载顺序：
Applications 注册表中修改加载控制参数。联系技术支持：
现象
在 AutoCAD 2020 中保存的 DWG 文件，在 AutoCAD 2019 中打开时提示"版本过高无法打开"。
说明
这是 AutoCAD 自身的 DWG 文件格式版本问题，与 LightningCAD 无关。AutoCAD 2019 和 2020 使用相同的 DWG 文件格式版本（R23.x），因此通常不存在此问题。如果出现，可能是保存时选择了更高版本的格式。
解决方案
另存为兼容格式：
设置默认保存版本：
SAVEASDEFAULT 命令，将默认保存格式设置为较低的 DWG 版本。现象
在 AutoCAD 中正常使用的某些 LightningCAD 功能，在中望CAD 中无法执行或提示"功能不支持"。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | API 差异 | 中望CAD 的 .NET API 与 AutoCAD 存在少量差异 |
| 2 | 自定义实体渲染差异 | 自定义实体在中望CAD 中的显示效果可能与 AutoCAD 不同 |
| 3 | 版本限制 | 某些功能可能需要中望CAD 2025 及以上版本才支持 |
解决方案
确认中望CAD 版本：
执行 REGEN 刷新：
REGEN 或 REGENALL 刷新显示。反馈问题：
ABOUT 查看）。本节涵盖软件运行性能、资源占用和稳定性相关的问题。
现象
当图纸中包含大量板材（数百块以上）、节点线或收边时，CAD 操作明显变慢，包括平移、缩放、选择对象等基本操作都出现延迟。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | 实体数量过多 | 单个 DWG 文件中包含的自定义实体数量超出 CAD 的流畅处理范围 |
| 2 | 图层未合理管理 | 所有实体都在同一图层，无法通过图层冻结减少渲染负担 |
| 3 | 硬件性能不足 | 计算机 CPU、内存或显卡性能不满足大型项目需求 |
| 4 | 图纸文件过大 | DWG 文件体积过大（超过 50MB） |
解决方案
分图管理：
合理利用图层：
升级硬件：
3DCONFIG 命令）。清理图纸：
PURGE 命令清理图纸中未使用的图层、块定义、线型等冗余数据。AUDIT 命令检查并修复图纸中的错误。关闭不必要的显示：
现象
CAD 在操作过程中突然崩溃退出、弹出"致命错误"对话框，或长时间处于"无响应"状态。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | 图纸文件损坏 | DWG 文件存在数据结构错误 |
| 2 | 内存不足 | 系统内存耗尽导致 CAD 无法分配更多资源 |
| 3 | 插件异常 | LightningCAD 或其他插件的代码异常导致 CAD 崩溃 |
| 4 | 显卡驱动问题 | 显卡驱动不兼容或版本过旧 |
| 5 | 操作数据量过大 | 一次性执行的操作涉及过多实体 |
解决方案
修复图纸文件：
RECOVER 命令打开损坏的 DWG 文件，CAD 将尝试自动修复。AUDIT 命令对已打开的图纸进行错误检查和修复。检查内存使用：
Ctrl + Shift + Esc 打开任务管理器，查看内存使用率。查看崩溃日志：
%AppData%\FsLt\Logs\ 目录下的日志文件：
LaunchCAD_{日期}.log（记录插件加载和初始化过程）fslt-plugin.txt（记录插件运行时的详细操作和错误信息）Fatal 或 Error 级别记录通常包含崩溃原因。更新显卡驱动：
3DCONFIG，尝试关闭硬件加速测试是否改善。避免大数据量操作：
启用自动备份：
SAVETIME 系统变量，建议设为 10~15 分钟）。现象
LightningCAD 客户端或 CAD 进程的内存占用持续增长，长时间使用后达到数 GB，导致系统变慢。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | 大型图纸缓存 | CAD 在内存中缓存了大量图形数据 |
| 2 | 日志文件过大 | 日志级别设为 Verbose/Debug 时，日志写入量巨大 |
| 3 | 内存泄漏 | 长时间运行后，某些操作未能正确释放内存 |
解决方案
定期重启 CAD：
调整日志级别：
关闭不必要的图纸：
清理缓存：
%AppData%\FsLt\Cache\ 目录下的临时文件。现象
%AppData%\FsLt\ 目录或 DWG 文件同级目录下的备份文件占用大量磁盘空间。
可能原因
LightningCAD 的文件自动备份功能会定期创建备份文件，长时间使用后备份文件会不断累积。
解决方案
清理旧备份：
%AppData%\FsLt\ 目录，检查各子目录的磁盘占用。调整备份策略：
清理日志文件：
%AppData%\FsLt\Logs\ 目录下。LaunchCAD_{日期}.log），客户端日志按天滚动（lt-client-{日期}.txt）。本节涵盖自动更新、网络连接和心跳检测相关的问题。
现象
客户端启动后未自动检测更新，或手动点击"检查更新"后提示"检测失败"。状态栏始终不显示版本信息。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | 网络不通 | 无法访问阿里云 OSS 更新服务器 |
| 2 | 防火墙拦截 | 防火墙阻止了客户端的更新检测请求 |
| 3 | 更新配置文件异常 | 服务器端的更新配置文件暂时不可访问 |
解决方案
检查网络连通性：
检查防火墙：
Fs.Lt.Client.exe 的网络访问权限。手动检查更新：
稍后重试：
现象
更新窗口中下载进度条停滞不前，或提示"下载失败"。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | 网络不稳定 | 下载过程中网络断连或速度过慢 |
| 2 | 磁盘空间不足 | 安装目录所在磁盘剩余空间不足 |
| 3 | CAD 进程占用 | CAD 正在运行，文件被锁定无法替换 |
解决方案
确保网络稳定：
检查磁盘空间：
关闭 CAD 后重试：
手动下载安装：
现象
完成版本更新后，之前的个人设置（如主题、快捷键、CAD 注册状态等）丢失，需要重新配置。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | 大版本升级重置 | 某些大版本更新可能不兼容旧版配置格式 |
| 2 | 配置文件迁移失败 | 更新过程中配置文件未能正确迁移 |
解决方案
重新配置：
检查备份：
%AppData%\FsLt\UserProfiles\ 目录下。反馈问题：
现象
标题栏的服务器状态指示灯持续显示红色（"服务器未连接"），即使网络正常也无法恢复。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | Token 已失效 | AccessToken 和 RefreshToken 均已过期或被吊销 |
| 2 | 服务端接口异常 | 心跳检测接口暂时不可用 |
| 3 | 客户端时间不同步 | 计算机的系统时间与服务器时间偏差过大 |
解决方案
重新登录：
检查系统时间：
等待自动恢复：
检查网络环境：
本节涵盖配置文件、公共库文件和图纸文件相关的问题。
现象
客户端或 CAD 插件启动时提示"配置文件读取失败"、"配置数据异常"，或某些功能因配置错误无法正常使用。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | 意外断电/崩溃 | 写入配置文件时发生中断，导致文件内容不完整 |
| 2 | 手动编辑出错 | 用户手动修改了 JSON 配置文件，引入了语法错误 |
| 3 | 磁盘错误 | 存储介质出现坏道导致文件损坏 |
解决方案
客户端配置恢复：
%AppData%\FsLt\UserProfiles\ 目录。UserProfiles 文件夹重命名为 UserProfiles_damaged。CAD 插件配置恢复：
%AppData%\FsLt\Configs\ 目录。排布配置方案恢复：
.cfg\Configs\ 目录下。.configs.json 文件。从备份恢复：
%AppData%\FsLt\ 整个目录。现象
使用板材库浏览器、节点库浏览器或收边库浏览器时，提示"库文件不存在"或库列表为空。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | 安装不完整 | 安装过程中公共库/标准库文件未正确部署 |
| 2 | 文件被误删 | 用户或杀毒软件误删了库文件 |
| 3 | 路径配置错误 | 库文件搜索路径未正确指向安装目录 |
解决方案
检查库文件目录：
Resources\StandardLibraries\ 文件夹。重新安装：
检查模板目录：
Resources\Templates\ 文件夹中包含必要的模板文件（如 FsLtTemplate.dwt、ShouBian_DingYi_Template.dwg 等）。现象
打开 DWG 图纸文件时，CAD 提示"图形文件无效"或"文件已损坏"，无法正常打开。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | 保存过程中断 | 保存图纸时发生断电、崩溃或强制关闭 |
| 2 | 磁盘错误 | 存储介质出现物理损坏 |
| 3 | 文件传输损坏 | 通过网络传输或复制过程中文件损坏 |
解决方案
使用 RECOVER 命令修复：
RECOVER 并回车。使用 AUDIT 命令检查：
AUDIT 命令。从备份恢复：
%AppData%\FsLt\ 下）。.sv$ 文件），通常位于：%AppData%\Autodesk\AutoCAD 2019\R23.0\chs\Support\
%AppData%\ZWSOFT\ZWCAD\2022\chs\Support\
.sv$ 文件扩展名改为 .dwg 后尝试打开。从 .bak 文件恢复：
.bak 备份文件（与 DWG 同目录）。.bak 文件扩展名改为 .dwg 后尝试打开。现象
从 LightningCAD 导出统计表或 BOM 表到 Excel 文件后，打开文件发现中文内容显示为乱码。
可能原因
| 序号 | 原因 | 说明 |
|---|---|---|
| 1 | Excel 编码识别问题 | Excel 未能正确识别导出文件的字符编码 |
| 2 | CSV 格式编码不匹配 | 如果导出为 CSV 格式，编码可能不是 UTF-8 BOM |
| 3 | 系统区域设置 | 操作系统的区域和语言设置影响 Excel 的默认编码 |
解决方案
使用 Excel 的"数据"导入功能：
检查导出格式：
.xlsx 格式导出选项，优先使用 .xlsx 格式（原生支持 Unicode）。添加 BOM 标记：
如果按照本章各问题的解决方案仍无法解决您遇到的问题，请通过以下渠道联系 LightningCAD 技术支持团队。
| 渠道 | 说明 |
|---|---|
| 客户端内置反馈 | 在 CAD 中使用 LightningCAD 工具包的"用户问题反馈"功能，可直接提交问题描述和截图 |
| 授权 QQ 群 | 加入 LightningCAD 官方授权 QQ 群，在群内反馈问题可获得快速响应 |
| 邮箱 | 联系您的服务提供商获取技术支持邮箱地址，发送详细问题描述 |
提交问题时，请尽量附上相关的日志文件，这将极大提高问题定位效率。
日志文件位置：
| 日志类型 | 文件路径 | 说明 |
|---|---|---|
| CAD 插件加载日志 | %AppData%\FsLt\Logs\LaunchCAD_{日期}.log |
记录 CAD 启动时插件的加载过程和结果 |
| CAD 插件运行日志 | %AppData%\FsLt\Logs\fslt-plugin.txt |
记录插件运行时的详细操作、警告和错误信息（Serilog + Sentry 架构） |
| 客户端日志 | %AppData%\FsLt\Logs\lt-client-{日期}.txt |
记录客户端的运行日志，按天滚动，保留最近 30 天 |
获取步骤：
Win + R，输入 %AppData%\FsLt\Logs 并回车。开启调试模式获取更详细日志：
如果常规日志信息不足以定位问题，可以在客户端"设置"中开启"调试模式"：
注意：调试模式会输出大量详细信息，建议仅在排查问题时临时开启，问题解决后及时关闭。
提交问题时，请参照以下模板提供信息，以便技术支持团队快速定位问题：
【问题标题】：简要描述问题现象
【产品版本】：LightningCAD 客户端版本号（如 v1.2.3）
【CAD 平台】：AutoCAD 2019 / AutoCAD 2020 / 中望CAD 2022 / 中望CAD 2025
【操作系统】：Windows 10 / Windows 11，64位
【问题描述】：
1. 问题发生的具体操作步骤
2. 预期结果是什么
3. 实际结果是什么
【错误提示】：如有错误弹窗，请截图或记录完整的错误信息
【日志文件】：已附上 %AppData%\FsLt\Logs\ 目录下的相关日志文件
【截图/录屏】：如有，请附上问题现象的截图或录屏
【复现频率】：必现 / 偶现（大约 X 次中出现 Y 次）
【其他信息】：是否安装了其他 CAD 插件、最近是否更新过系统等
如果问题无法通过文字描述和日志分析解决，技术支持团队可能会请求远程协助：
| 方式 | 说明 |
|---|---|
| 远程桌面 | 使用 ToDesk、向日葵等远程桌面工具，由技术支持人员远程操作您的计算机进行排查 |
| 屏幕共享 | 通过 QQ 群视频或腾讯会议等工具共享屏幕，由技术支持指导您操作 |
| 日志远程收集 | 技术支持可能指导您使用 LightningCAD 内置的运维工具（FsOmTools）收集和上传诊断信息 |
运维工具使用：
FsOmTools.exe 运维工具。本节汇总 LightningCAD 中可能遇到的常见错误代码及其含义和解决方案。
LightningCAD 客户端与服务器通信时，可能返回以下状态码：
| 状态码 | 含义 | 常见场景 | 解决方案 |
|---|---|---|---|
| 200 | 请求成功 | — | 正常 |
| 400 | 请求参数错误 | 登录时提交的参数格式不正确 | 检查输入内容是否合法，重新提交 |
| 401 | 未授权/Token 失效 | Token 过期或被吊销 | 注销后重新登录获取新 Token |
| 403 | 禁止访问 | 账号权限不足或设备未授权 | 确认账号具有相应权限，检查许可证状态 |
| 404 | 资源不存在 | 请求的接口或数据不存在 | 确认操作正确，如持续出现请联系技术支持 |
| 409 | 资源冲突 | 如邮箱已被注册 | 使用其他邮箱或登录已有账号 |
| 429 | 请求过于频繁 | 短时间内发送了过多请求（如验证码） | 等待倒计时结束后重试 |
| 500 | 服务器内部错误 | 服务端发生未预期的异常 | 稍后重试，如持续出现请联系技术支持 |
| 502 | 网关错误 | 服务端网关不可用 | 等待几分钟后重试 |
| 503 | 服务不可用 | 服务器维护中 | 等待服务恢复后重试 |
CAD 启动时加载插件可能出现的错误信息：
| 错误信息 | 含义 | 解决方案 |
|---|---|---|
加载成功 |
模块正常加载 | 正常 |
已加载 |
模块已在之前的加载中被载入 | 正常，无需处理 |
文件不存在 |
指定的 DLL/ARX/ZRX 文件在安装目录中未找到 | 重新安装 LightningCAD |
加载失败，错误码: {数字} |
ARX/ZRX 文件加载返回了非成功状态码（非 5100） | 检查文件是否被杀毒软件隔离；确认 CAD 版本与插件版本匹配 |
无法加载程序集 |
.NET DLL 加载失败 | 确认 .NET Framework 4.8 已安装；检查 DLL 依赖是否完整 |
安全警告：是否加载 |
CAD 安全机制阻止了非信任路径的 DLL 加载 | 将 SECURELOAD 设为 0，或重新注册插件以配置信任路径 |
LightningCAD 在操作 CAD 图纸内部数据（XRecord）时可能遇到的错误：
| 错误代码 | 含义 | 说明 | 解决方案 |
|---|---|---|---|
Error |
通用错误 | XRecord 读写操作发生未预期的异常 | 使用 AUDIT 命令修复图纸；如持续出现，提交日志给技术支持 |
NodNotFound |
命名对象字典未找到 | 图纸中不存在 LightningCAD 所需的命名对象字典 | 执行单体初始化命令 FsInitBuilding |
XrecordNotFound |
XRecord 记录未找到 | 指定的 XRecord 键值在字典中不存在 | 可能是数据未正确写入，尝试重新执行相关操作 |
NodLockedForWrite |
命名对象字典被锁定 | 其他操作正在写入字典，当前操作被阻塞 | 等待当前操作完成后重试；如持续锁定，重启 CAD |
NotAnEntity |
非实体对象 | 尝试将非图形对象作为实体处理 | 可能是图纸数据异常，使用 AUDIT 修复 |
以下是按问题现象快速定位解决方案的速查表：
| 问题现象 | 首要排查步骤 | 参考问题 |
|---|---|---|
| 客户端无法启动 | 检查 .NET Framework 4.8；清理 %AppData%\FsLt\UserProfiles\ |
Q4, Q5 |
| CAD 中无菜单 | 重新注册插件；手动加载 CUI 文件 | Q2 |
| 插件加载失败 | 检查文件完整性；调整 SECURELOAD |
Q3 |
| 无法登录 | 检查网络；确认验证码正确 | Q8, Q9, Q10 |
| 频繁掉线 | 检查网络稳定性；重新登录 | Q11 |
| 排布结果异常 | 检查边界闭合性；验证排布参数 | Q15, Q19 |
| 板材重叠 | 运行碰撞检查；检查边界交叉 | Q16 |
| 统计表不准 | 重新生成统计表；检查 ID 重复 | Q21 |
| 节点线位置错误 | 检查规则映射配置；调整缩进值 | Q22, Q23 |
| CAD 崩溃 | 修复图纸（RECOVER）；更新显卡驱动 | Q33 |
| 更新失败 | 关闭 CAD；检查网络和磁盘空间 | Q36, Q37 |
| 服务器未连接 | 检查网络；重新登录 | Q8, Q39 |
| 导出乱码 | 使用 UTF-8 BOM 编码打开 | Q43 |
| 配置损坏 | 删除配置目录重启 | Q40 |
| 许可证问题 | 联系服务提供商申请/续期许可证 | Q14 |
温馨提示：LightningCAD 团队持续优化产品稳定性和兼容性。如果您遇到了本章未涵盖的问题，请通过 11.9 节中的反馈渠道告知我们，我们将在后续版本中持续改进。感谢您的支持与信任！
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。