问题排查指南
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 保存为
.bat文件（例如：qoder_Debug.bat）。 - 安装路径：确认 Qoder 安装在默认目录
C:\Users\<YourUsername>\.qoder。
## **运行诊断脚本**
### **步骤 1：运行脚本**
- 找到已保存的
.bat文件。
示例：qoder_Debug.bat
- 双击该文件以执行脚本。
- 脚本将自动运行，收集系统和应用程序数据。
⚠️ 请等待脚本完全执行完成。不要提前关闭命令窗口。
### **步骤 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<br/>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。 请附上生成的日志文件： Qoder_Log_YYYYMMDD_HHMMSS.txt，以便更快获得支持。 |
Allen
暂无介绍....
上一篇
终端执行异常
下一篇
