Mac终端中Vite React App打开Chrome而非默认浏览器Brave的问题

原因分析 #

Vite的o命令本质是调用系统open工具（或底层依赖的npm包）启动浏览器，出现问题通常有两种情况：

• 系统GUI界面已将Brave设为默认浏览器，但终端环境下的open命令因Launch Services缓存未同步，仍识别Chrome为默认选项
• Vite的open工具未正确读取系统默认浏览器配置，优先调用了已安装的Chrome

解决办法 #

1. 确认系统默认浏览器设置

打开「系统设置」→「桌面与程序坞」→「默认网页浏览器」，确保选中「Brave Browser」，设置完成后重启终端再尝试o命令。

2. 重置Launch Services缓存（修复终端open命令关联）

终端执行以下命令重置系统应用关联数据库，解决缓存导致的识别错误：

/System/Library/Frameworks/CoreServices.framework/Versions/A/Frameworks/LaunchServices.framework/Versions/A/Support/lsregister -kill -r -domain local -domain system -domain user

执行后重启终端，测试open http://localhost:5173是否打开Brave，再回到Vite开发环境输入o。

3. 在Vite中强制指定打开Brave

若上述方法无效，可直接在Vite配置中指定浏览器：

• 修改vite.config.js（或vite.config.ts）：

export default {
  server: {
    open: {
      app: {
        name: 'Brave Browser'
      }
    }
  }
}

• 或通过命令行临时指定：

npm run dev -- --open "Brave Browser"

4. 直接指定Brave可执行文件路径

如果系统未正确识别Brave路径，可直接配置完整路径：

export default {
  server: {
    open: {
      app: {
        path: '/Applications/Brave Browser.app/Contents/MacOS/Brave Browser'
      }
    }
  }
}

内容的提问来源于stack exchange，提问作者migmaker