安装失败多由签名校验 / 权限 / 架构 / 下载损坏导致。
1. Windows 排查
问题 | 现象 | 解决 |
---|---|---|
权限不足 | 安装卡住/写入失败 | 右键“以管理员身份运行” |
杀软拦截 | 界面闪退/EXE 被隔离 | Defender/第三方加入白名单 |
架构不符 | 启动立即退出 | 确认系统 & 安装包均为 x64 / arm64 |
缺运行库 | 提示 MSVCP*** | 安装 VC++ 运行库合集 |
延伸:启动后崩溃请参考 Verge 启动问题
2. macOS 排查
# 解除隔离属性
sudo xattr -rd com.apple.quarantine /Applications/ClashX.app
若提示"已损坏"/“来自未确认的开发者”:参考 macOS 应用损坏。
问题 | 现象 | 解决 |
---|---|---|
未信任来源 | 打不开 | 系统设置 → 隐私与安全性 → 允许仍要打开 |
Rosetta 需求 | Apple Silicon 旧版本 | 安装 arm64 原生或安装 Rosetta2 |
权限拒绝 | 日志显示 sandbox deny | 从访达重新授予执行权限 |
3. 通用校验
- 校验文件完整(官方仓库 / 校验和)
- 避免代理软件本身被旧版本覆盖(完整卸载再装)
- 安装路径避免中文/空格(极少数客户端仍有兼容问题)
4. 仍无法解决
- 换便携版(portable)或使用无需安装的 Release 压缩包
- 打开系统日志 (Event Viewer / Console.app) 搜索 crash / deny
- 在 Issue 中附:系统版本 + 日志片段 + 下载来源
更多迁移/备份见 备份迁移。