VSCode 更新后 Cmd(Ctrl)+点击终端地址在编辑器内部打开?一个设置帮你搞定

VSCode 更新后 Cmd+点击终端地址在编辑器内部打开?一个设置帮你搞定

一个小小设置项的变化,差点让我以为 VSCode 出了什么 bug

背景

最近 VSCode 更新后,我发现了一个很别扭的变化:

以前在终端里看到 http://localhost:5173/ 这样的地址,Cmd + 点击 就会自动在系统默认浏览器(比如 Chrome 或 Safari)中打开。但更新之后,点击链接却直接在 VSCode 编辑器内部打开了,体验非常割裂。

排查了一圈,发现是 VSCode 新增的一个默认设置项在作祟。

问题现象

终端输出如下:

当我像往常一样按住 Cmd 点击 http://localhost:5173/ 时,链接在 VSCode 内置的 Webview 面板中打开了,而不是我想要的系统浏览器。

问题原因

VSCode 在近几个版本中新增了一个默认启用的设置项:

Terminal › Integrated: Local Link Open In Webview

顾名思义,这个设置的作用就是将终端中的 localhost 链接强制在 VSCode 内部的 Webview 面板打开。官方可能是为了方便开发者在编辑器内快速预览,但对于习惯了使用系统浏览器的开发者来说,这个改动反而增加了操作成本。

解决方案

方法一:通过设置界面关闭(推荐)

  1. 按下 Cmd + , 打开 VSCode 设置
  2. 在搜索框中输入 Open Localhost Links 或 localLinkOpenInWebview
  3. 找到 Terminal › Integrated: Local Link Open In Webview 选项
  4. 取消勾选 (将 true 改为 false)

修改后无需重启 VSCode,再次点击终端中的 localhost 链接即可在系统默认浏览器中打开。

方法二:直接修改 settings.json

如果习惯直接编辑配置文件,可以在 settings.json 中添加:

json 复制代码
{
  "terminal.integrated.localLinkOpenInWebview": false
}

方法三:检查是否安装了 Browser Tab 插件

如果你安装了 Browser Tab 插件(AdiEfrat.vscode-browser-tab),它也可能会拦截终端链接。可以检查该插件的 terminalLinks 设置是否启用,如有必要也可一并关闭。

延伸思考:用户设置 vs 工作区设置

在修改设置的过程中,你可能会发现 VSCode 的设置面板分为 "用户" 和 "工作区" 两个标签页,而且需要分别修改。

这其实是 VSCode 设计上的一个灵活特性,而非缺陷:

特性 用户设置 (User) 工作区设置 (Workspace)
作用范围 全局生效,影响所有项目 仅对当前项目生效
配置文件位置 用户目录下 项目根目录的 .vscode/settings.json
优先级 较低 较高(会覆盖用户设置)
是否提交 Git ❌ 不提交 ✅ 建议提交,方便团队共享

即使你的电脑只有你一个人使用,工作区设置仍然有它的价值:

  • 项目隔离:不同项目可能使用不同的代码规范(缩进、格式化工具等),工作区设置可以让 VSCode 在切换项目时自动适配
  • 可迁移性 :将 .vscode 文件夹提交到 Git 后,换新电脑时只需 git clone,所有项目配置就能自动生效

如果你觉得工作区设置对你来说是多余的,直接删除项目根目录下的 .vscode 文件夹,只使用用户设置即可。

总结

  1. 核心问题 :VSCode 更新后默认开启 terminal.integrated.localLinkOpenInWebview,导致终端 localhost 链接在编辑器内部打开
  2. 解决方法:在设置中关闭该选项即可恢复原有行为
  3. 延伸知识:用户设置和工作区设置各有不同的作用范围和优先级,理解它们的区别可以更好地管理 VSCode 配置

希望这篇文章能帮你解决类似的小困扰。如果你也有其他 VSCode 使用技巧或踩坑经历,欢迎在评论区分享交流!


💡 本文首发于稀土掘金,欢迎点赞、收藏、评论三连 🙏

相关推荐
ServBay3 天前
Local harness 将退役,VS Code 本地开发要不要搬到云端?
后端·ai编程·visual studio code
DigitalOcean22 天前
不受限于 Copilot,教你在 VS Code 中接入 GPT、Claude
agent·visual studio code
formulahendry1 个月前
为什么全世界都在 Fork 它?VS Code 官方纪录片(中字完整版)正式上线!
微软·visual studio code·vs code
三十而立洋1 个月前
知枝 · MindSprout:可以直接将 markdown 转换为思维导图的 vscode 插件
前端·visual studio code
formulahendry1 个月前
在 VS Code 里自由切换 Copilot、Claude、Codex、OpenCode、Pi、Kimi、Qwen:任何 Agent 都能接
visual studio code·vs code·acp
开开心心就好1 个月前
打印机卡住打不了?一键清理卡死打印队列
服务器·开发语言·算法·pdf·ocr·idea·visual studio code
free-elcmacom2 个月前
手撕 memcpy 和 memmove:从字节级拷贝到内存重叠的终极较量
c语言·开发语言·青少年编程·visual studio code·visual studio
free-elcmacom2 个月前
发际线警告!手撕《C陷阱与缺陷》终极 BOSS:signal 函数与 typedef 魔法
c语言·开发语言·visual studio code·visual studio
前端小白乘风2 个月前
VS Code 终于能连微信了!发现一个硬核开源神仙插件:WeChat AHP
微信·visual studio code·deepseek
free-elcmacom2 个月前
C语言指针进阶——指针数组模拟二维数组,以及二级指针到底怎么理解
c语言·visual studio code