VS Code CodeLens 怎样按语言关闭引用提示

如果只有某一种语言的引用提示让编辑器变得拥挤，不必把 VS Code 的 CodeLens 全局关闭。更稳妥的做法是打开语言专属设置，只给目标语言写入 editor.codeLens: false，其他语言继续保留原来的引用信息。

官方地址：https://code.visualstudio.com/

本文以 TypeScript 为例，菜单名称和设置范围同样适用于 Markdown、CSS 等其他语言。官方设置说明：https://code.visualstudio.com/docs/configure/settings。

先判断：你要关的是哪一层提示

CodeLens 是显示在代码行附近的上下文信息，引用数量是其中一种表现。VS Code 官方文档说明，引用信息可以通过 editor.codeLens 控制；如果只想处理某种语言，就要把这个设置放进语言专属范围，而不是直接修改全局 User Settings。

这一区分很重要：全局关闭会影响所有语言，语言专属关闭只改变匹配到的语言模式。下面的步骤不涉及扩展安装，也不处理远程窗口的扩展同步。

打开设置编辑器并找到 CodeLens

1. 打开 VS Code，按 Ctrl+,（macOS 为 ⌘,），或者按 Ctrl+Shift+P（macOS 为 ⇧⌘P）执行 Preferences: Open Settings。
2. 在设置搜索框输入 CodeLens，也可以直接搜索 editor.codeLens。
3. 确认列表里出现 Editor: Code Lens，先不要急着关闭它；此时要先确定右侧显示的是 User、Workspace，还是语言专属范围。

如果这里直接点击开关，改到的通常是当前选中的普通设置范围。想要只影响 TypeScript，继续给设置搜索框加上语言过滤条件。

用 @lang 过滤器切换到语言专属设置

1. 在同一个设置搜索框中输入 @lang:typescript editor.codeLens。typescript 是 VS Code 的语言标识，不是显示名称随意拼出来的中文名称。
2. 如果不想手动输入过滤器，按 Ctrl+Shift+P（macOS 为 ⇧⌘P），执行 Preferences: Configure Language Specific Settings，再选择 TypeScript。
3. 回到 Editor: Code Lens，关闭开关。此时修改的是 TypeScript 对应的语言专属设置，不会把 JavaScript、Markdown 等语言一起关闭。

设置编辑器会直接写入配置。若界面没有出现语言过滤后的设置项，先确认当前文件的语言模式是否真的是 TypeScript；也可以通过状态栏右下角的语言模式入口选择对应语言，再进入配置。

需要可审查配置时，直接写 settings.json

图形界面适合第一次操作，团队项目则常常需要把范围写得清楚。执行 Preferences: Open Workspace Settings (JSON)，在工作区的 .vscode/settings.json 中加入下面的严格 JSON 片段。JSON 不支持注释，所以字段含义放在代码块之后说明。

{
  "[typescript]": {
    "editor.codeLens": false
  }
}

[typescript] 表示只匹配 TypeScript 语言模式，editor.codeLens 为 false 表示关闭该语言的 CodeLens。这个文件位于工作区中，提交到版本库后，使用同一工作区的成员也会获得这条项目级设置。

如果要同时处理多个语言，可以使用多个语言块；不要把不同语言无条件合并成一个模糊的键。比如 JavaScript 与 TypeScript 需要相同设置时，可以按 VS Code 的多语言专属键写成 [javascript][typescript]，但单语言块与多语言块同时存在时，单语言值优先。

按优先级检查为什么设置没有生效

语言专属设置并不是脱离其他配置单独存在。VS Code 的设置范围通常从默认、User、Remote、Workspace 到 Workspace Folder，再叠加语言专属层；策略设置还可能由管理员强制覆盖。遇到开关看似关闭、代码里仍显示引用信息时，按下面顺序排查：

1. 在设置搜索框加入 @modified，确认目标设置确实被写入，而不是只搜索到了默认值。
2. 检查当前文件的语言模式与配置键是否一致，例如 TypeScript 应使用 [typescript]，不能把文件扩展名直接当作语言标识。
3. 检查 Workspace 或 Workspace Folder 是否存在更具体的 editor.codeLens 配置。工作区语言设置会优先于普通范围，但同一语言的工作区值也会覆盖 User 范围。
4. 重新打开一个目标语言文件，再查看引用提示是否消失。不要用另一种语言的文件判断这条规则是否生效。

三种常见误区

误区一：把 CodeLens 和参数提示当成同一项。 editor.codeLens 只控制 CodeLens，参数提示、内联提示等功能可能由其他设置控制，不能通过关闭 CodeLens 一并清理。

误区二：把编辑器设置写进了错误的范围。 如果你只想影响当前项目，优先使用 Workspace Settings；如果只想影响个人所有项目，使用 User Settings。先选范围，再改开关。

误区三：输入多个 @lang 过滤器期待同时生效。 官方文档提示，设置搜索框输入多个语言过滤器时，当前行为只使用第一个过滤器。需要多语言统一配置时，改用 settings.json 的多语言专属键并明确检查优先级。

最后这样确认最稳

把目标语言文件和另一种语言文件各打开一份：目标语言应不再显示 CodeLens，另一种语言仍按原设置显示；随后在设置编辑器中用 @modified 搜索，确认设置值落在正确的 User 或 Workspace 范围。这样既达到了“按语言关闭引用提示”，也避免为了一个语言问题把整个编辑器的导航信息全部关掉。

相关问题

只想关闭引用数量，保留其他 CodeLens 可以吗？ 需要看具体语言服务或扩展是否提供独立的引用 CodeLens 设置；editor.codeLens 是总开关，不能保证只隐藏某一种 CodeLens。

为什么 settings.json 写了键但界面仍显示提示？ 先看当前语言标识和设置范围，再检查是否有更具体的 Workspace Folder、Remote 或策略设置覆盖。

关闭 CodeLens 会影响跳转到定义吗？ 不会直接取消定义、查找引用等命令；它主要控制编辑器中显示的 CodeLens 信息。