修复在 VS Code 中使用内置浏览器时出现的 ERR_CERT_AUTHORITY_INVALID 错误
这个错误是由于 VS Code 内置的 Electron Chromium 浏览器不认可本地开发服务器的自签名SSL证书导致的,以下是几种针对性的解决方案:
方法一:信任本地开发环境的SSL证书
不同前端脚手架(如 Create React App、Vite)提供了官方证书信任方式,确保本地证书被系统和 Chromium 信任:
针对 Create React App 项目
在项目根目录执行官方证书信任命令:
# Windows(PowerShell) $env:NODE_EXTRA_CA_CERTS="$(npm config get cafile)" npm start # macOS/Linux export NODE_EXTRA_CA_CERTS="$(npm config get cafile)" npm start # 或直接运行专用信任脚本 npx trust-local-cert
针对 Vite 项目
Vite 会自动生成本地证书,可通过以下步骤信任:
- 启动项目后,用系统浏览器访问 HTTPS 本地地址(如
https://localhost:5173) - 在浏览器安全提示中选择 高级 → 继续访问
- 导出证书(地址栏锁图标 → 证书 → 详细信息 → 复制到文件,选择Base64编码保存为
.pem文件),后续可导入到VS Code信任存储(见方法三)
方法二:修改VS Code调试配置,使用HTTP而非HTTPS
若无需强制使用HTTPS调试,可切换到HTTP协议:
- 打开VS Code 运行和调试面板(Ctrl+Shift+D),创建/编辑
launch.json文件 - 修改
url为HTTP开头的地址,移除SSL相关配置:
{ "version": "0.2.0", "configurations": [ { "type": "chrome", "request": "launch", "name": "Launch React App", "url": "http://localhost:3000", // 替换为你的HTTP本地地址 "webRoot": "${workspaceFolder}/src" // 注释/删除所有SSL相关配置(如"runtimeArgs"中的证书忽略项) } ] }
方法三:手动导入证书到VS Code内置浏览器信任列表
- 按方法一的步骤导出本地开发证书为
.pem文件 - 打开VS Code设置(Ctrl+,),搜索并勾选
security.enterpriseRoots.enabled,让VS Code复用系统信任的证书 - 若仍无效,可在调试配置中添加忽略证书错误的参数(仅用于开发环境):
{ "configurations": [ { "type": "chrome", "request": "launch", "name": "Launch with Cert Ignore", "url": "https://localhost:3000", "webRoot": "${workspaceFolder}/src", "runtimeArgs": [ "--ignore-certificate-errors", "--ignore-ssl-errors" ] } ] }
验证解决效果
完成配置后重启VS Code调试(F5),检查内置浏览器是否能正常加载页面。
⚠️ 注意:
--ignore-certificate-errors参数仅适合开发场景,生产环境绝对不能使用,会带来严重安全风险。




