本文介紹通過使用 Lingma 指令碼的方式對靈碼啟動等問題的排查，Lingma 指令碼可以自動收集系統內容資訊、網路設定、Lingma 服務狀態以及相關日誌，以便於快速診斷和解決可能遇到的問題。本文介紹如何使用 Lingma 排查指令碼以及如何根據指令碼輸出排查問題。
前提條件
確認您的系統是 Windows，並且具有管理員權限運行此指令碼；
下載並儲存windows_lingma.bat指令碼為“.bat”檔案（例如“Lingma_Debug.bat”）；
確保已將靈碼按照預設路徑（“C:\Users\<YourUsername>\.lingma”）正確安裝。
操作步驟
運行指令碼：雙擊儲存好的“.bat”檔案啟動指令碼；
查看日誌：指令碼執行完畢後，會自動開啟產生的記錄檔。日誌路徑會顯示在命令列視窗中，通常位於指令碼同級目錄下，名為“Lingma_Log_日期時間.txt”。
問題排查指南
問題類型 | 問題項 | 解決方式 |
網路 | 檢查代理設定 | 指令碼會查詢代理是否啟用。通過查看“[網路設定 0x0為未啟動代理]”部分，確認是否符合預期，如果有代理則需要在設定中給靈碼手動配置網路代理程式。 |
Lingma 服務狀態 | Lingma.exe 存在性 | 指令碼首先驗證 Lingma.exe 是否存在。若報錯，請檢查安裝路徑是否正確，並嘗試刪除 .lingma 目錄重啟 ide，重建 .lingma 目錄。 |
版本與啟動測試 | 查看“[version測試]”和“[啟動Lingma]”部分，確認 Lingma 版本資訊並且可以串連到公網伺服器，如果報 failed，請根據報錯中的 URL 在設定中配置代理訪問公網。 | |
Lingma.exe 進程啟動但登入仍然沒有反應 | 需要給 windows 防火牆（控制台\系統和安全 \Windows Defender 防火牆\允許的應用）加一下進程檔案的白名單之後再重試登入：C:\Users\xxx\.lingma\bin\2.X.X\x86_64_windows\lingma.exe 。 | |
如果報不相容的程式 | 如果是 IDEA 有可能是因為堆記憶體不足，會導致解壓失敗，請點擊右下角靈碼表徵圖，選擇進階設定，修改路徑到非 C 盤的路徑下去，以空檔案夾結尾，之後重啟 IDEA。 說明 注意有部分公司內部會對二進位程式進行加鎖導致無法運行。 | |
提示“通義靈碼啟動中”（或報啟動異常，檢查服務無反應）怎麼辦？ |
| |
系統相容性 | 系統與硬體資訊 | 指令碼收集了作業系統版本和 CPU 型號，檢查“[作業系統資訊]”部分，確認是否滿足 Lingma 的系統要求。 |
日誌分析 | Lingma 應用日誌 | 產生的記錄檔會記錄“lingma.log”的最後80行，有助於識別 Lingma 運行時的具體錯誤或警告，您可以自行分析日誌中的錯誤。 |
目錄結構與檔案大小 | 指令碼還提供了 Lingma 安裝目錄的結構和各檔案大小，可用於空間佔用檢查或檔案完整性驗證。 | |
無法自主排查的問題 | 請進DingTalk群“靈碼公測交流群（答疑請先看群公告）”，群號為： |