下面按照常见系统给出一套从快到慢的排查步骤,优先从简单方法开始。请根据你的系统选择对应部分。

通用快速检查
- 确认从官方网站下载:brave.com/zh/download 或 brave.com/msi(企业版离线安装包)。避免第三方站点。
- 重新下载一次,确保下载完整;若文件属性中显示“此文件来自其他计算机,可能被阻止”,点击“解除阻止”。
- 检查 CPU 架构与安装包匹配(x64/ARM64/x86),以及系统是否在受限模式(例如 Windows S 模式)。
- 断网/内网环境下优先使用离线安装包(MSI/Standalone),避免在线安装器因网络或代理阻断而无响应。
- 临时关闭杀毒/防护软件或将安装器加入白名单,之后再恢复。
- 确保磁盘剩余空间充足,系统时间正确。
Windows
- 先试这几步
- 右键以管理员身份运行安装器。
- 重启电脑后再尝试。
- 使用离线安装包(推荐):访问 brave.com/msi,选择与你架构匹配的 MSI(x64/ARM64/x86)。双击或用 msiexec 安装:
msiexec /i BraveBrowser*.msi /qn
若需要可去掉 /qn 以显示界面。 - 避免网络拦截:在线安装器需要直连 Brave 的更新服务器。若在公司网络或代理后面,使用离线 MSI;或让 IT 放行域名 brave.com、laptop-updates.brave.com。
- 如果双击没反应
- 检查是否被 SmartScreen/组策略阻止。右键文件属性→解除阻止;或在“Windows 安全中心→应用和浏览器控制”里暂时允许。
- 检查是否已有残留安装进程:任务管理器结束 Brave*、BraveBrowserSetup.exe、msiexec.exe。
- 清理临时目录:在资源管理器地址栏输入 %TEMP%,删除与 Brave/BraveInstaller 相关的临时文件后重试。
- 检查 TEMP/TMP 环境变量是否可用:按 Win+R 输入 %TEMP% 回车能否打开;若报错,修复环境变量到存在的目录(例如 C:\Users\你的用户名\AppData\Local\Temp)。
- 确认不在 Windows S 模式。S 模式下无法安装传统桌面应用,可改用 Microsoft Store 版(在 Microsoft Store 搜索“Brave Browser”),或退出 S 模式。
- 检查是否被“受控制的文件夹访问”阻止:Windows 安全中心→病毒和威胁防护→勒索软件防护→允许应用通过受控文件夹访问,将安装器加入允许列表。
- 获取日志定位问题
- 在线安装器(BraveBrowserSetup.exe)可加参数输出详细日志:
BraveBrowserSetup.exe –verbose-logging –do-not-launch-chrome
日志一般在 %LOCALAPPDATA%\Temp 或 %TEMP%,名称包含 Brave/BraveInstaller。 - 查看事件查看器:事件查看器→Windows 日志→应用程序,查找与 Brave/安装器相关错误。
- 若提示网络错误或证书问题,优先改用离线 MSI,或修正系统代理(命令提示符运行 netsh winhttp show proxy 查看;若被设置,联系网络管理员或改为直连)。
- 其他可能性与修复
- 残留/半安装状态:已安装项中卸载 Brave;删除以下目录后再装:
C:\Program Files\BraveSoftware
C:\Program Files (x86)\BraveSoftware
C:\Users\你的用户名\AppData\Local\BraveSoftware\ - 被防毒软件拦截:完全退出/临时禁用后试安装,再恢复保护。
- Windows Installer 服务异常:重启电脑;或以管理员命令行运行
net stop msiserver
net start msiserver - 系统文件问题:以管理员命令行运行 sfc /scannow,然后再安装。
macOS
- 下载官方 DMG,确保架构匹配(Intel/Apple Silicon)。
- 若提示“无法验证开发者”或“已损坏”,可右键点击应用选择“打开”,或在系统设置→安全性与隐私允许此应用。
- 若仍报“已损坏”,在终端执行(将路径改为你的安装位置):
xattr -dr com.apple.quarantine "/Applications/Brave Browser.app" - 将应用拖入“应用程序”后再从“应用程序”启动,不要直接从 DMG 运行。
- 若有管理策略/MDM 限制,需要管理员放行或改用受管理的分发方式。
Linux
- 建议使用官方仓库安装而非单独安装包。
- Debian/Ubuntu 系:
- 导入签名键:
sudo curl -fsSLo /usr/share/keyrings/brave-browser-archive-keyring.gpg https://brave-browser-apt-release.s3.brave.com/brave-browser-archive-keyring.gpg - 添加仓库:
echo "deb [signed-by=/usr/share/keyrings/brave-browser-archive-keyring.gpg] https://brave-browser-apt-release.s3.brave.com/ stable main" | sudo tee /etc/apt/sources.list.d/brave-browser-release.list - 安装:
sudo apt update && sudo apt install brave-browser
- 导入签名键:
- Fedora/RHEL/openSUSE 请按 Brave 官方文档配置 repo 后安装。
- 若图形安装器无法启动,检查缺失依赖(如 libnss3、libatk、libx11 等),或直接用命令行安装。
仍然不行时
- 说明你的系统版本、架构、是否公司网络/代理、是否 S 模式、你用的安装包名称与来源,以及是否有任何错误代码或日志片段。我可以根据这些信息给出更精确的解决方案与命令。


