本文介绍通过使用 Lingma 诊断脚本对通义灵码启动等问题进行排查。该脚本可以自动收集系统环境信息、网络配置、Lingma 服务状态以及相关日志，帮助您快速定位并解决问题。
1. 下载与运行脚本
请根据您的操作系统，下载并运行对应的诊断工具：
Windows环境
下载脚本：点击下载windows_lingma.bat。
执行脚本：找到文件，右键单击并选择“以管理员身份运行”。
查看结果：脚本执行完毕后，会自动打开生成的日志文件。日志路径会显示在命令行窗口中，通常位于脚本同级目录下，名为“Lingma_Log_日期时间.txt”。
Linux/macOS环境
下载脚本：点击下载linuxormac_lingma_cn.sh
执行脚本：打开终端（Terminal），进入脚本所在目录，执行以下命令。
授予脚本执行权限。
chmod +x Linuxormac_lingma_cn.sh运行脚本。
./Linuxormac_lingma_cn.sh
查看结果：脚本执行完毕后，会生成日志文件。日志文件通常位于脚本同级目录下，名为"Lingma_Log_日期时间.txt"。
2. 诊断结果排查建议
以下内容适用于所有操作系统（Windows、macOS、Linux）。根据脚本生成的日志文件，您可以按照下表进行问题排查：
问题类型 | 问题项 | 解决方式 |
网络 | 检查代理设置 | 脚本会查询代理是否启用。通过查看"[网络设置]"或"[代理设置]"部分，确认是否符合预期。如果有代理，则需要在设置中给通义灵码手动配置网络代理。 |
Lingma 服务状态 | Lingma 进程存在性 | 脚本首先验证 Lingma 进程是否存在（Windows 为 Lingma.exe，macOS 和 Linux 为 lingma）。若报错，请检查安装路径是否正确，并尝试删除 .lingma 目录重启 IDE，重新生成 .lingma 目录。 |
版本与启动测试 | 查看"[version测试]"和"[启动Lingma]"部分，确认 Lingma 版本信息并且可以连接到公网服务器。如果报 failed，请根据报错中的 URL 在设置中配置代理访问公网。 | |
进程启动但登录仍然没有反应 | Windows：需要给 Windows 防火墙（控制面板\系统和安全\Windows Defender 防火墙\允许的应用）添加进程文件的白名单之后再重试登录：C:\Users\xxx\.lingma\bin\2.X.X\x86_64_windows\lingma.exe。macOS/Linux：检查系统防火墙设置，确保 Lingma 进程有网络访问权限。 | |
如果报不兼容的程序 | 如果是 IDEA，有可能是因为堆内存不足导致解压失败。请点击右下角灵码图标，选择高级设置，修改路径到非系统盘的路径下（以空文件夹结尾），之后重启 IDEA。 说明 注意有部分公司内部会对二进制程序进行加锁导致无法运行。 | |
提示"通义灵码启动中"（或报启动异常，检查服务无反应）怎么办？ |
| |
系统兼容性 | 系统与硬件信息 | 脚本收集了操作系统版本和 CPU 型号，检查"[操作系统信息]"部分，确认是否满足 Lingma 的系统要求。 |
日志分析 | Lingma 应用日志 | 生成的日志文件会记录"lingma.log"的最后若干行（通常为 80 行），有助于识别 Lingma 运行时的具体错误或警告。您可以自行分析日志中的错误信息。 |
目录结构与文件大小 | 脚本还提供了 Lingma 安装目录的结构和各文件大小，可用于空间占用检查或文件完整性验证。 | |
无法自主排查的问题 | 请进钉钉群"通义灵码公测交流群（答疑请先看群公告）"，群号为： |