先决条件
- 操作系统：Windows
- 权限：以管理员权限运行脚本，以便完整访问系统设置和日志。
- 脚本文件：下载并将 windows_Qoder.bat 保存为
.bat文件（例如：qoder_Debug.bat）。 - 安装路径：确认 Qoder 安装在默认目录
C:\Users\<YourUsername>\.qoder。
运行诊断脚本
步骤 1：运行脚本
- 找到已保存的
.bat文件。
qoder_Debug.bat
- 双击该文件以执行脚本。
- 脚本将自动运行，收集系统和应用程序数据。
步骤 2：查看生成的日志
- 会自动打开生成的日志文件。
- 日志文件路径会显示在命令窗口中。
- 默认情况下，日志会保存在与脚本相同的目录下，文件名格式为：
Qoder_Log_YYYYMMDD_HHMMSS.txt。- 示例：
Qoder_Log_20250405_143022.txt
- 示例：
常见问题
| 问题类型 | 问题 | 解决方案 |
|---|---|---|
| 网络 | 检查代理设置 | 脚本会检查是否启用了代理。请查看 [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，以便更快获得支持。 |