确认语言ID需用“Developer: Inspect Editor Languages”命令查看面板中的“Language ID”字段，如typescriptreact、markdown、shellscript；项目级设置须写在工作区.vscode/settings.json顶层，格式为"[language-id]": {配置项}。
VSCode 的语言特定设置（Language-specific Settings）不是靠“全局开关”启用的，而是通过 settings.json 中带 "[language-id]" 语法的对象块来生效——没写对 language-id，配置就完全不触发。
怎么确认当前文件的语言 ID？
这是最容易卡住的第一步。VSCode 内部用 language-id（如 javascript、typescriptreact、python）匹配设置，不是文件扩展名或你看到的右下角显示名。
- 打开一个目标文件（比如
App.tsx），按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS） - 输入并执行命令：
Developer: Inspect Editor Languages - 弹出面板里看 “Language ID” 字段值，常见但易错的有：
typescriptreact（不是tsx）、markdown（不是md）、shellscript（不是bash）
项目级语言设置必须写在工作区 settings.json 里
用户级设置（User Settings）中的语言块对单个项目无效；只有放在当前工作区根目录下的 .vscode/settings.json 中，才能精准控制该项目的行为。
- 确保该文件存在且顶层是合法 JSON 对象（不能以数组或注释开头）
- 语言配置块必须是顶层属性，格式为：
"[typescriptreact]": { "editor.formatOnSave": true } - 多个语言可并列写，互不干扰：
"[python]": { ... }, "[jsonc]": { ... } - 若项目含多种前端语言，
[typescriptreact]和[javascript]需分开配，它们不继承彼此
哪些设置支持语言特定覆盖？
不是所有设置都能被语言块接管。只有标有 “Language Override” 图标的设置才支持（在设置 UI 中悬停可见）。典型可用项包括：
-
editor.formatOnSave、editor.formatOnType（常用于禁用 Markdown 自动换行） -
editor.tabSize（比如 Python 强制 4，Shell 要 2） -
editor.insertSpaces（YAML 必须 true，Makefile 必须 false） -
files.associations不支持语言块覆盖，得写在顶层 -
emeraldwalk.runonsave等插件设置，是否支持取决于插件自身是否声明了 language-override 能力
容易被忽略的冲突点：扩展自带语言配置优先级更高
有些扩展（如 Prettier、ESLint、Black）会在激活时注入自己的语言级默认设置，它们的优先级高于工作区 settings.json 中的手动配置。
- 例如：Prettier 默认关掉
editor.formatOnSaveforjavascript，即使你在[javascript]块里设为true，也可能被覆盖 - 解决方法：查该扩展文档，找对应 language-id 的专属配置项（如
prettier.requireConfig或eslint.enable），或在语言块中显式重置其行为 - 调试技巧：打开命令面板 →
Preferences: Configure Language Specific Settings...，选语言后编辑，VSCode 会自动帮你生成正确结构
language-id 拼错、放错 settings.json 位置、误以为所有设置都可覆盖——这三个点占了 90% 的失败案例。配完记得重启编辑器窗口或重开文件，部分设置（如 tabSize）不会热更新。
