问题排查指南__Qoder CN_智能编码助手-Qoder CN 系列(Lingma)-阿里云帮助中心

本文介绍通过使用 Qoder CN 诊断脚本对Qoder CN启动等问题进行排查。该脚本可以自动收集系统环境信息、网络配置、Qoder CN 服务状态以及相关日志，帮助您快速定位并解决问题。

重要

Qoder CN 系列全新文档站点现已上线。当前站点的文档内容可能无法反映产品的最新功能与变化，请访问 docs.qoder.cn 获取最新产品文档。

1. 下载与运行脚本

请根据您的操作系统，下载并运行对应的诊断工具：

Windows环境

下载脚本：点击下载windows_lingma.bat。
执行脚本：找到文件，右键单击并选择“以管理员身份运行”。
查看结果：脚本执行完毕后，会自动打开生成的日志文件。日志路径会显示在命令行窗口中，通常位于脚本同级目录下，名为“Qoder CN_Log_日期时间.txt”。

Linux/macOS环境

下载脚本：点击下载linuxormac_lingma_cn.sh
执行脚本：打开终端（Terminal），进入脚本所在目录，执行以下命令。
1. 授予脚本执行权限。
```
chmod +x Linuxormac_lingma_cn.sh
```
2. 运行脚本。
```
./Linuxormac_lingma_cn.sh
```
查看结果：脚本执行完毕后，会生成日志文件。日志文件通常位于脚本同级目录下，名为"Qoder CN_Log_日期时间.txt"。

2. 诊断结果排查建议

以下内容适用于所有操作系统（Windows、macOS、Linux）。根据脚本生成的日志文件，您可以按照下表进行问题排查：

问题类型	问题项	解决方式
网络	检查代理设置	脚本会查询代理是否启用。通过查看"[网络设置]"或"[代理设置]"部分，确认是否符合预期。如果有代理，则需要在设置中给Qoder CN手动配置网络代理。
Qoder CN 服务状态	Qoder CN 进程存在性	脚本首先验证 Qoder CN 进程是否存在（Windows 为 Lingma.exe，macOS 和 Linux 为 lingma）。若报错，请检查安装路径是否正确，并尝试删除 .lingma 目录重启 IDE，重新生成 .lingma 目录。
	版本与启动测试	查看"[version测试]"和"[启动Qoder CN]"部分，确认 Qoder CN 版本信息并且可以连接到公网服务器。如果报 failed，请根据报错中的 URL 在设置中配置代理访问公网。
	进程启动但登录仍然没有反应	Windows：需要给 Windows 防火墙（控制面板\系统和安全\Windows Defender 防火墙\允许的应用）添加进程文件的白名单之后再重试登录：C:\Users\xxx\.lingma\bin\2.X.X\x86_64_windows\lingma.exe。macOS/Linux：检查系统防火墙设置，确保 Qoder CN 进程有网络访问权限。
	如果报不兼容的程序	如果是 IDEA，有可能是因为堆内存不足导致解压失败。请点击右下角Qoder CN图标，选择高级设置，修改路径到非系统盘的路径下（以空文件夹结尾），之后重启 IDEA。说明注意有部分公司内部会对二进制程序进行加锁导致无法运行。
	提示"Qoder CN启动中"（或报启动异常，检查服务无反应）怎么办？	请确认操作系统和系统架构是否支持。如果支持，请检查后台任务管理器（Windows）或活动监视器（macOS）或系统监视器（Linux）是否有 lingma 进程。如果没有，请将Qoder CN升级到最新版，并尝试以下步骤解决：结束 Qoder CN 进程。删除 .lingma 目录（Windows：C:\Users\[用户名]\.lingma；macOS/Linux：~/.lingma）。使用管理员权限（Windows）或 sudo 权限（macOS/Linux）重启 IDE。如果问题仍然存在，请在 .lingma/bin/x.x.x/ 目录下运行启动命令。Windows：在命令行（cmd）中运行 `Lingma.exe start`。macOS/Linux：在终端中运行 `./lingma start`。等待进程出现后重新点击登录。如果报不兼容的程序，应该是解压失败导致的（有可能是 IDE 堆内存不足，会导致解压失败）。请点击右下角Qoder CN图标，选择高级设置，修改路径到非系统盘的路径下（以空文件夹结尾），之后重启 IDE。
系统兼容性	系统与硬件信息	脚本收集了操作系统版本和 CPU 型号，检查"[操作系统信息]"部分，确认是否满足 Qoder CN 的系统要求。
日志分析	Qoder CN 应用日志	生成的日志文件会记录"lingma.log"的最后若干行（通常为 80 行），有助于识别 Qoder CN 运行时的具体错误或警告。您可以自行分析日志中的错误信息。
	目录结构与文件大小	脚本还提供了 Qoder CN 安装目录的结构和各文件大小，可用于空间占用检查或文件完整性验证。
	无法自主排查的问题	请进钉钉群"Qoder CN公测交流群（答疑请先看群公告）"，群号为：`53770000738`，联系官方答疑小助手。