VSCode 代码片段不提示？原来是这个默认配置在“搞鬼”

一次看似莫名其妙的 VSCode 更新，背后藏着一个关于配置优先级的“陷阱”。

前言

最近我在使用 VSCode 时遇到了一个非常让人头疼的问题：我明明配置了代码片段（Snippets），但输入前缀时，VSCode 却没有任何提示。

我的第一反应是“是不是我哪里配置错了？”于是我开始排查，最终发现问题的根源竟然藏在 VSCode 的一个默认配置里——而且这个配置是 VSCode 在某个版本更新时自动写入的！

这篇文章就带大家完整复盘整个排查过程，帮助你下次遇到同样问题时可以“一击必杀”。

问题现象

在写代码时，输入自定义代码片段的前缀（比如 for、if 等），VSCode 的补全下拉框完全不弹出，就像代码片段根本不存在一样。

但检查后发现：

代码片段文件（.code-snippets）存在且内容正确
语言模式（scope）匹配
文件类型正确

一切看起来都正常，但就是不提示。

排查过程

第一步：检查核心设置

在 VSCode 的设置中，我检查了以下几个关键配置项：

{
  "editor.suggest.showSnippets": true,
  "editor.snippetSuggestions": "top",
  "editor.quickSuggestions": {
    "other": true,
    "comments": false,
    "strings": false
  }
}

理论上，只要这些配置正确，代码片段就应该正常工作。

但奇怪的是，在用户级（全局）配置中，我发现了这样一段配置：

"editor.quickSuggestions": {
    "other": "offWhenInlineCompletions",
    "comments": "off",
    "strings": "off"
}

这是什么意思呢？

第二步：理解 `offWhenInlineCompletions`

offWhenInlineCompletions 是 VSCode 在近几个大版本（特别是 1.70+）中引入的新策略，含义是：

当“内联补全”（Inline Completions）可用时，自动关闭传统的下拉建议框。

而“内联补全”就是你写代码时，光标后面显示的那段灰色虚影文字（比如 GitHub Copilot 或 VSCode 自带的 AI 预测）。

VSCode 的设计者认为，如果灰字提示已经显示，再弹出一个下拉框会显得杂乱，于是干脆默认把下拉框给关了。

但问题在于：代码片段的触发完全依赖于这个下拉建议框！下拉框被关掉，代码片段自然就“消失”了。

第三步：为什么项目配置里写 `"other": true` 能解决？

我在项目根目录下的 .vscode/settings.json 中添加了：

"editor.quickSuggestions": {
    "other": true
}

结果代码片段立刻恢复正常了。

原因在于 VSCode 的配置优先级：

项目（工作区）设置 > 用户（全局）设置

我并没有在项目配置中修改过 editor.quickSuggestions，但用户级配置里有一个“关闭下拉框”的指令，导致全局失效。
而我在项目级明确写下了 "other": true，这条指令的优先级更高，直接覆盖了全局的 offWhenInlineCompletions，所以代码片段恢复了。

根本原因总结

VSCode 更新后自动写入了新的默认配置：

  "editor.quickSuggestions": {
      "other": "offWhenInlineCompletions",
      "comments": "off",
      "strings": "off"
  }

这个策略导致在“内联补全”可用时，下拉建议框被关闭
代码片段依赖于下拉建议框，因此失效
项目级配置覆盖了全局配置后问题消失

解决方案

方案一：修改全局配置（推荐）

打开用户级配置文件：

按 Ctrl+Shift+P（macOS: Cmd+Shift+P）
输入 Preferences: Open User Settings (JSON)
找到 "editor.quickSuggestions"，将 "other" 改为 "on"：

"editor.quickSuggestions": {
    "other": "on",
    "comments": "off",
    "strings": "off"
}

保存后，所有项目都会恢复正常。

方案二：在项目配置中覆盖（临时方案）

在项目根目录的 .vscode/settings.json 中添加：

"editor.quickSuggestions": {
    "other": true
}

此方法仅对当前项目生效，适合临时测试或团队共享配置。

附加知识点：VSCode 配置优先级

优先级	配置级别	文件位置
最高	工作区（项目）设置	`.vscode/settings.json`
中	用户（全局）设置	`settings.json`（用户目录）
最低	VSCode 默认设置	内置默认值

了解这个优先级机制，可以帮助你快速定位类似配置问题。

结语

这次问题最终证明不是“VSCode 抽风”，也不是我配置错了，而是 VSCode 为了推广内联补全而修改默认策略导致的“副作用”。幸运的是，通过理解配置优先级机制，我们完全可以掌握主动权，让 VSCode 按我们的习惯工作。