VSCode设置搜索不到自定义项是因为仅识别已注册的configuration字段；when条件需用上下文键而非JS表达式；插件动态快捷键不显示在UI中；工作区设置受schema限制，并非全部生效。
搜索工作区设置时为什么搜不到自定义项
VSCode 的「设置」搜索框默认只匹配内置设置项和已启用插件的配置，不会显示你手动在 settings.json 里写的、但未被任何插件或核心功能注册的字段。比如你写了 "myCustomFlag": true，它不会出现在设置 UI 的搜索结果里——这不是 bug，是设计行为。
- 真正生效的设置必须有对应的
configuration声明（通常由插件或 VS Code 自身提供 schema） - 直接编辑
.vscode/settings.json可以写任意键值，但只有被识别的字段才支持搜索、校验、hover 提示 - 想确认某个设置是否可搜，先查官方文档或插件 README，看它是否公开了 configuration key
修改局部参数时 when 条件写错导致快捷键失效
在 keybindings.json 中给命令加 when 条件，是控制快捷键生效范围的关键，但也是最容易出错的地方。常见错误是把编辑器上下文条件写成字符串字面量，比如 "when": "editorTextFocus == true" —— 这样写不生效，因为 when 表达式不支持 JavaScript 语法，只认特定的上下文键和布尔运算符。
- 正确写法是
"when": "editorTextFocus"（等价于真值判断），或"when": "editorTextFocus && !inDebugRepl" -
editorTextFocus表示光标在普通文本编辑器中；terminalFocus表示焦点在终端；explorerViewletVisible表示资源管理器可见 - 条件名大小写敏感，且不能带引号、括号或比较操作符（
==、===都不行） - 可用的上下文键列表可在 VS Code 源码的
src/vs/platform/contextkey/common/contextkey.ts查到，或通过命令面板运行Developer: Toggle Developer Tools后在 Console 输入contextKeys查看当前可用项
全局搜索快捷键被插件覆盖却找不到源头
Ctrl+Shift+F（Windows/Linux）或 Cmd+Shift+F（macOS）被改掉，但你在键盘快捷方式界面搜 search 却没看到它被谁占用了？大概率是某个插件用 registerKeybinding API 动态注册了冲突快捷键，而这类绑定不会出现在图形化快捷键列表中。
- 打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools - 切换到 Console 标签页，输入
Object.keys(require('vs/workbench/services/keybinding/common/abstractKeybindingService').KeybindingService.prototype).filter(k => k.includes('key'))（实际调试时建议用更轻量的方式：直接看keybindings.json是否有重复"key": "ctrl+shift+f"的条目） - 更实用的办法：禁用所有插件，重启 VS Code，再逐个启用，观察
Ctrl+Shift+F是否恢复 - 如果问题出在插件，检查其
package.json的contributes.keybindings字段，或查阅该插件的 issue 页面
工作区级 settings.json 和用户级设置的优先级容易混淆
VSCode 设置分三层：用户（global）、工作区（workspace）、文件夹（folder）。很多人以为工作区设置会无条件覆盖用户设置，其实不是——某些设置是「仅用户级有效」，比如 telemetry.enableTelemetry 或 update.mode，它们在工作区 settings.json 里写出来也不会生效，VS Code 会静默忽略。
- 判断一个设置是否支持工作区级，最可靠方法是打开设置 UI，点击右上角「{}」图标进入 JSON 编辑模式，然后把鼠标悬停在某个设置项上：如果提示里写着
Default: ..., Workspace: true，说明支持；若只写Default: ...，则不支持 - 路径相关设置（如
files.exclude、search.exclude）天然支持工作区级，且会叠加生效（工作区设置 + 用户设置合并） - 布尔型或字符串型设置通常可覆盖，但涉及系统行为、安全或更新策略的设置，往往强制锁定在用户层
when 表达式、插件动态注册的隐藏快捷键——这些才是实际调试中最常卡住人的点。 
