安装失败的常见报错与对应处理方法

安装包本身的问题

下载中断导致文件不完整是最常见的原因。用下载页提供的 SHA-256 校验值核对一遍，不一致就重新下载，不要反复点击已损坏的安装包。

如果反复下载都校验失败，可能是网络传输过程中的问题。换一个下载时段，或换一台设备下载后再传输过来。

权限与残留

Windows 上如果提示「需要管理员权限」，右键安装包选择「以管理员身份运行」即可。

如果提示「已安装其他版本」，说明旧版本没有卸载干净。到控制面板卸载后，手动清理安装目录下的残留文件，再重新安装。

macOS 上如果提示应用已存在，把「应用程序」文件夹里的旧版本拖到废纸篓，然后清空废纸篓再安装。

安全软件拦截

部分安全软件会主动拦截网络类工具的安装，因为它们需要注入网络栈或安装虚拟网卡驱动。这是正常的技术需求，不是恶意行为。

可以在安装时临时关闭实时防护，安装完成后重新开启，并把客户端安装目录加入白名单，避免后续被误杀。（示例数据，上线前请替换）