> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 问题排查指南
本文介绍如何使用 Qoder 诊断脚本排查 Qoder 的启动与连接问题。该脚本会自动收集关键系统信息，包括环境信息、网络配置、Qoder 服务状态及相关日志，帮助快速定位并解决常见问题。
## **先决条件**
在运行诊断脚本之前，请确认以下事项：
* 操作系统：Windows
* 权限：以管理员权限运行脚本，以便完整访问系统设置和日志。
* 脚本文件：下载并将 [windows\_Qoder.bat](https://qoder-ide.oss-ap-southeast-1.aliyuncs.com/Diagnosis/windows_qoder.bat) 保存为 `.bat` 文件（例如：`qoder_Debug.bat`）。
* 安装路径：确认 Qoder 安装在默认目录 `C:\Users\\.qoder`。
## **运行诊断脚本**
### **步骤 1：运行脚本**
1. 找到已保存的 `.bat` 文件。
示例：`qoder_Debug.bat`
2. 双击该文件以执行脚本。
3. 脚本将自动运行，收集系统和应用程序数据。
⚠️ 请等待脚本完全执行完成。不要提前关闭命令窗口。
### **步骤 2：查看生成的日志**
脚本执行完成后：
* 系统会自动生成一个包含所收集日志文件和关键配置文件的 ZIP 压缩包。\
文件名格式：`qoder-diagnosis_YYYYMMDD_HHMMSS.zip`\
*示例：*`qoder-diagnosis_Sat_2025-10-11_16-00-03.93.zip`
* 主要日志文件已包含在压缩包中，命名格式：`Qoder_Log_YYYYMMDD_HHMMSS.txt`\
*示例：*`Qoder_Log_20250405_143022.txt`
* 你可以将整个诊断 ZIP 包发送给 Qoder 官方团队，以便协助问题定位与排障。
## **常见问题**
| 问题类型 | 问题 | 解决方案 |
| ----------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 网络 | 检查代理设置 | 脚本会检查是否启用了代理。请查看 `[Network Settings 0x0 means proxy is disabled]` 部分以确认预期行为。
如在使用代理，请在设置中为 Qoder 手动配置网络代理。 |
| Qoder 服务器状态 | Qoder.exe 是否存在 | 脚本会检查 Qoder.exe 是否存在。
如出现错误：
1. 检查安装路径。
2. 删除 .qoder 目录。
3. 重启 IDE 以重新生成该目录。 |
| | 版本与启动测试 | 查看 \[Version Test] 和 \[Start Qoder] 部分以确认：
\* Qoder 版本
\* 与公共服务器的连接情况
若显示“failed”，请使用错误信息中的 URL 在设置中配置代理访问。 |
| | Qoder.exe 运行但登录失败 | 将可执行文件加入 Windows 防火墙白名单：
路径：
1. Windows：C:\Users\用户名\AppData\Local\Programs\Qoder\resources\app\resources\bin\`CPU\_architecture\_64\_system`\Qoder.exe
2. Mac：/Applications/Qoder.app/Contents/Resources/app/resources\bin\`CPU\_architecture\_64\_system\`\Qoder
步骤：
控制面板 → 系统和安全 → Windows Defender 防火墙 → 允许的应用 → 允许其他应用
然后重试登录。 |
| 系统兼容性 | 系统与硬件信息 | 脚本会收集：
\* 操作系统版本（如 Windows 10/11）
\* CPU 型号
查看 \[Operating System Information] 以确认系统满足 Qoder 的要求：
\* Windows 10 或更高版本（64 位）
\* x86\_64 兼容 CPU |
| 日志分析 | Qoder 应用日志 | 生成的日志包含 `qoder.log` 的最后 80 行。
可用于定位运行时错误、警告或连接问题。 |
| | 目录结构与文件大小 | 脚本会列出 .qoder 下的完整目录结构和文件大小。可用于：
\* 检查磁盘占用
\* 验证文件完整性（例如缺失或异常小的文件） |
| 注意 | 二进制执行限制 | 某些企业环境会限制或阻止可执行文件运行，这可能导致 Qoder 无法启动。
如果应用无法启动，请联系 IT 部门以调整权限。 |
| 无法自行解决的问题 | 超出自助排障范围的问题 | 如仍无法解决，请联系： [contact@qoder.com](mailto:contact@qoder.com)。
请附上生成的日志文件：`Qoder_Log_YYYYMMDD_HHMMSS.txt`，以便更快获得支持。 |