全部產品
Search

搜尋本產品

    Qoder CN 系列：問題排查指南

    文件中心

    Qoder CN 系列：問題排查指南

    更新時間：Sep 25, 2026

    本文介紹通過使用 Qoder CN 診斷指令碼對Qoder CN啟動等問題進行排查。該指令碼可以自動收集系統內容資訊、網路設定、Qoder CN 服務狀態以及相關日誌，協助您快速定位並解決問題。

    重要

    Qoder CN 系列全新文檔網站現已上線。當前網站的文檔內容可能無法反映產品的最新功能與變化，請訪問 docs.qoder.cn 擷取最新產品文檔。

    1. 下載與運行指令碼

    請根據您的作業系統，下載並運行對應的診斷工具：

    Windows環境

    1. 下載指令碼：點擊下載windows_lingma.bat。

    2. 執行指令碼：找到檔案，按右鍵並選擇“以管理員身份運行”。

    3. 查看結果：指令碼執行完畢後，會自動開啟產生的記錄檔。日誌路徑會顯示在命令列視窗中，通常位於指令碼同級目錄下，名為“Qoder CN_Log_日期時間.txt”。

    Linux/macOS環境

    1. 下載指令碼：點擊下載linuxormac_lingma_cn.sh

    2. 執行指令碼：開啟終端（Terminal），進入指令碼所在目錄，執行以下命令。

      1. 授予指令碼執行許可權。

        chmod +x Linuxormac_lingma_cn.sh

      2. 運行指令碼。

        ./Linuxormac_lingma_cn.sh

    3. 查看結果：指令碼執行完畢後，會組建記錄檔檔案。記錄檔通常位於指令碼同級目錄下，名為"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啟動中"（或報啟動異常，檢查服務無反應）怎麼辦？

    1. 請確認作業系統和系統架構是否支援。如果支援，請檢查背景工作管理器（Windows）或活動監視器（macOS）或系統監視器（Linux）是否有 lingma 進程。

    2. 如果沒有，請將Qoder CN升級到最新版，並嘗試以下步驟解決：

      1. 結束 Qoder CN 進程。

      2. 刪除 .lingma 目錄（Windows：C:\Users\[使用者名稱]\.lingma；macOS/Linux：~/.lingma）。

      3. 使用管理員權限（Windows）或 sudo 許可權（macOS/Linux）重啟 IDE。

    3. 如果問題仍然存在，請在 .lingma/bin/x.x.x/ 目錄下運行啟動命令。Windows：在命令列（cmd）中運行 Lingma.exe start。macOS/Linux：在終端中運行 ./lingma start。等待進程出現後重新點擊登入。

    4. 如果報不相容的程式，應該是解壓失敗導致的（有可能是 IDE 堆記憶體不足，會導致解壓失敗）。請點擊右下角Qoder CN表徵圖，選擇進階設定，修改路徑到非系統硬碟的路徑下（以空檔案夾結尾），之後重啟 IDE。

    系統相容性

    系統與硬體資訊

    指令碼收集了作業系統版本和 CPU 型號，檢查"[作業系統資訊]"部分，確認是否滿足 Qoder CN 的系統要求。

    日誌分析

    Qoder CN 應用日誌

    產生的記錄檔會記錄"lingma.log"的最後若干行（通常為 80 行），有助於識別 Qoder CN 運行時的具體錯誤或警告。您可以自行分析日誌中的錯誤資訊。

    目錄結構與檔案大小

    指令碼還提供了 Qoder CN 安裝目錄的結構和各檔案大小，可用於空間佔用檢查或檔案完整性驗證。

    無法自主排查的問題

    請進DingTalk群"Qoder CN公測交流群（答疑請先看群公告）"，群號為：53770000738，聯絡官方答疑小助手。