Qoder CN 安装失败——下载、解压、启动环节的常见问题
安装包无法下载
| 可能原因 | 解决 |
|---|---|
| 网络问题 | 检查网络连通性，换网络重试；或用浏览器下载 |
| 代理干扰 | 关闭 VPN / 代理重试；或在代理中放行 Qoder 官方网站域名 |
| 浏览器拦截 | 关闭广告拦截器、换浏览器重试 |
下载的安装包打不开 / 解压失败
| 可能原因 | 解决 |
|---|---|
| 下载不完整 | 删除后重新下载 |
| 文件损坏 | 校验文件大小，或换下载链接 |
| 磁盘空间不足 | 至少留出 500 MB 可用空间 |
Windows SmartScreen 拦截
Windows 可能提示「未识别的发布者」——这是正常的首次安装提示：
- 点击 更多信息 → 仍要运行；
- 安装继续进行。
macOS 「无法打开」提示
macOS 首次打开可能提示「App 来自互联网」或「无法验证开发者」：
- 前往 系统设置 → 隐私与安全性；
- 下拉到底部找到 Qoder CN 的提示；
- 点击 仍然打开；
- 这次之后就不会再提示了。
更新安装失败
如果你是从旧版本更新：
- 先 卸载旧版本；
- 去官方下载最新版安装包；
- 重新安装。
新版本不兼容旧版本残留文件时，卸载重装是最快的方式。
安装到一半报错退出
| 可能原因 | 解决 |
|---|---|
| 杀毒软件拦截 | 暂时关闭或添加 Qoder 到白名单 |
| 权限不足 | Windows 系统版需要管理员权限；用用户版或右键「以管理员身份运行」 |
| 安装路径有特殊字符 | 安装到默认路径（C:\Program Files\ 或 /Applications/） |
安装成功但启动闪退
详见 客户端无法启动。
还找不到原因
- 记录 操作系统版本 和 安装包来源；
- 卸载后重新下载最新版安装包；
- 还是不行 → 从客户端内的 Feedback 提交问题（或 Qoder 论坛发帖）。