VSCode怎么针对特定语言关闭预览模式

陌雪姑娘_2309

陌雪姑娘_2309

2026-11-10

251人浏览

原创

VSCode不支持直接按语言ID关预览,需用workbench.editorAssociations按文件后缀+viewType组合控制:设"enablePreview": false可强制常驻,如{ "viewType": "default", "filenamePattern": "*.ts", "enablePreview": false }。

vscode怎么针对特定语言关闭预览模式

怎么用 workbench.editorAssociations 按语言关预览

VSCode 不支持直接按语言 ID(如 python 或 typescript)开关预览,但能通过文件后缀 + 编辑器类型组合控制——核心是 workbench.editorAssociations 数组,它允许你为特定 filenamePattern 指定是否启用预览。

这个配置优先级高于全局 workbench.editor.enablePreview:即使全局设为 true,你仍可让 *.ts 强制常驻;反之,若全局已关,这里写 "enablePreview": true 也无效(不生效)。

  • viewType: "default" 表示使用内置文本编辑器(绝大多数情况都用这个)
  • filenamePattern 支持 * 和 **,比如 "*.py"、"src/**/*.test.js"
  • 规则按数组顺序匹配,靠前的先命中,所以更具体的模式(如 "foo.spec.ts")应放在通用模式(如 "*.ts")前面

示例(禁用所有 .ts 和 .tsx 文件的预览):

"workbench.editorAssociations": [
  {
    "viewType": "default",
    "filenamePattern": "*.ts",
    "enablePreview": false
  },
  {
    "viewType": "default",
    "filenamePattern": "*.tsx",
    "enablePreview": false
  }
]

workbench.editor.enablePreviewFromCodeNavigation 不是按语言控制的

别被名字误导:workbench.editor.enablePreviewFromCodeNavigation 控制的是「跳转定义/引用」行为(Ctrl+Click、F12、Shift+F12),和当前文件的语言无关——它对所有语言统一生效。如果你只想让 Python 跳转不预览、而 JS 保持预览,这个配置做不到。

真要实现语言级跳转行为差异,得看对应语言服务器是否提供独立配置。例如:

  • Pylance(Python)无公开 API 控制跳转预览行为
  • Volar(Vue)可通过 volar.preview.enable 关闭组件内跳转预览(非标准路径,需查其最新文档)
  • Rust Analyzer 目前不暴露该粒度开关

换句话说:VSCode 本身没给语言扩展留“跳转是否预览”的插槽,多数扩展直接调用 vscode.window.showTextDocument() 并传 { preview: false },你无法在用户设置里干预。

VSCode
VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

为什么 files.associations 对预览无效

files.associations 只决定“用哪个编辑器打开文件”,比如把 .log 当作 plaintext,或把 .yml 绑定到 yaml 语法高亮。它完全不参与预览逻辑判断。

常见错误操作:

  • 把 "*.ts": "typescript" 改成 "*.ts": "default" —— 无意义,default 不是合法 language ID
  • 以为加了 "*.md": "markdown" 就能控制 Markdown 预览页行为 —— 实际上 markdown.preview 是另一套视图系统,和标签页预览无关

真正影响 Markdown 预览页的是 markdown.preview.enable(控制右键 → “Open Preview” 是否可用),和编辑器标签栏的斜体预览是两回事。

容易被忽略的边界情况

即使你配好了 workbench.editorAssociations,以下场景仍可能触发预览,且无法通过该配置拦截:

  • Alt+Click(Windows/Linux)或 Option+Click(macOS)在资源管理器中点击文件:这是 editorGroup 的底层策略,硬编码,无视所有配置
  • 拖拽文件到另一个 editor group(split view):同样走 editorGroup 分发逻辑,不是预览 API
  • GitLens blame 行点击、Todo Tree 任务跳转:这些扩展内部调用 vscode.window.showTextDocument(..., { preview: true }),必须去对应扩展设置里找 enablePreview 类选项(如 GitLens 有 gitlens.codeLens.enablePreview)

最稳妥的做法是:先全局关掉 workbench.editor.enablePreview,再用 workbench.editorAssociations 做例外放行(比如保留 *.md 预览),而不是反过来——因为后者无法覆盖前者未覆盖的路径。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
vscode是什么_vscode怎么安装配置
vscode是什么_vscode怎么安装配置

VS Code(Visual Studio Code)是一款免费、开源的跨平台代码编辑器,由微软开发和维护。它被广泛用于软件开发和编程,支持多种编程语言和框架。VS Code 同时提供了丰富的功能和扩展性,使开发者可以高效地编写、编辑和调试代码。

2023.06.30

1595

18

vscode怎么运行代码
vscode怎么运行代码

vscode是一个运行于MacOS X、Windows和Linux之上的,针对于编写现代Web和云应用的跨平台源代码编辑器;vscode免费而且功能强大,对JavaScript和NodeJS的支持非常好,自带很多功能,例如代码格式化,代码智能提示补全、Emmet插件等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.21

3432

3

vscode使用的框架介绍
vscode使用的框架介绍

VSCode是一款跨平台代码编辑器,它基于Electron框架和Monaco Editor构建。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

2129

12

vscode一般用来写什么语言
vscode一般用来写什么语言

VSCode是一款功能强大的代码编辑器,支持多种编程语言和文件格式。它内置对 JavaScript、Python、Java、C++、TypeScript、HTML/CSS、Go 等语言的支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

1767

8

vscode可以写什么语言
vscode可以写什么语言

vscode是一款强大的代码编辑器,支持多种编程语言的开发。通过安装扩展,可以为 JavaScript/TypeScript、Python、Java、C#、PHP、Go、Ruby、Rust、HTML/CSS 等语言提供智能代码补全、调试和格式化等功能。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

2627

12

vscode中文设置方法
vscode中文设置方法

方法一:在设置页面中,搜索“locale”,并选择“zh-cn”。方法二:按“Ctrl Shift P”快捷键,输入“Configure Display Language”,将语言修改为“zh-cn”。如果上述方法无效,可考虑安装中文插件。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1858

14

vscode用途介绍
vscode用途介绍

Visual Studio Code(VSCode)是一款由 Microsoft 开发的多功能文本编辑器,适用于各种编程语言。作为一款开源软件,VSCode 拥有代码高亮、自动补全、调试、Git 集成等强大功能,成为程序员不可或缺的工具。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1302

10

vscode和visualstudio的区别
vscode和visualstudio的区别

Visual Studio是一款功能强大的集成开发环境(IDE),适用于专业开发人员进行复杂项目的构建。而VSCode则是一款轻量级的代码编辑器,更适合各种规模的项目开发。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1156

8

vscode设置中文界面不生效解决方法
vscode设置中文界面不生效解决方法

vscode设置中文界面不生效解决方法:安装中文语言包、通过命令面板设置语言、检查 locale.json 设置、重新安装中文语言包、检查 VSCode 版本和更新、排除插件冲突、检查系统语言设置、查看 VSCode 日志和错误消息、重置 VSCode 设置、查看官方文档和社区支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

574

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程