vscode中文界面需先安装官方简体中文语言包,再执行configure display language命令选zh-cn并重启;实用插件如prettier与eslint须配对安装并配置规则;快捷键应通过keybindings.json按条件覆盖,三者必须依次配置且不可跳步。

VSCode 要用中文界面 + 实用插件 + 顺手快捷键,三者必须分开配置、依次生效,缺一不可;任何一步跳过或顺序错乱,都会导致中文不显示、插件不加载、快捷键失效。
中文界面不是装个插件就完事,得改 locale.json 并重启
VSCode 自带简体中文语言包,但不会自动启用。很多人装了 Chinese (Simplified) Language Pack for Visual Studio Code 却还是英文,是因为没触发语言切换流程。
- 必须先按
Ctrl+Shift+P(macOS 是Cmd+Shift+P),输入并执行Configure Display Language - 在弹出列表中选
zh-cn,**不是输入、不是复制粘贴,是点击选择** - VSCode 会提示“需要重启”,点
Restart—— 这步不能跳,热重载不生效 - 重启后若仍为英文,检查设置里搜索
locale,确认settings.json中没有手动覆盖"locale"字段(它只该出现在locale.json)
Prettier 和 ESLint 插件必须配对安装,否则保存时格式化会冲突
单独装 Prettier 或单独装 ESLint 都可能让 editor.formatOnSave 失效,甚至删掉你代码里的分号或引号。
- 务必同时安装两个插件:
esbenp.prettier-vscode和dbaeumer.vscode-eslint - 项目根目录加
.eslintrc.js后,再装eslint-config-prettier和eslint-plugin-prettier(用 npm 安装,不是插件) - 在
settings.json中显式指定默认 formatter:"editor.defaultFormatter": "esbenp.prettier-vscode",否则 TypeScript 文件可能走错 formatter - 禁用 ESLint 的自动修复(
"eslint.autoFixOnSave": false),改用 Prettier 统一格式化,避免规则打架
快捷键绑定别直接改默认键位,优先用 keybindings.json 覆盖
在图形界面里点点点改快捷键,容易漏掉上下文条件(when),导致 Ctrl+S 在终端里也触发保存,或者 F12 在非编辑器区域失效。
- 按
Ctrl+K Ctrl+S打开快捷键面板,右上角点“打开键盘快捷方式(JSON)”——这会直接打开keybindings.json - 所有自定义都写进这个文件的数组里,例如折叠全部:
{"key":"ctrl+q","command":"editor.foldAll"} - 关键:加
"when":"editorTextFocus"条件,避免快捷键在搜索框、终端、侧边栏里误触发 - 想取消某个默认绑定(比如禁用
Ctrl+W关闭标签页),得写成:{"key":"ctrl+w","command":"-workbench.action.closeActiveEditor"},前面加减号
插件启用顺序影响功能可见性,Path Intellisense 必须在文件打开前加载
Path Intellisense 补全路径时卡住、不提示,往往不是插件坏了,而是它没抢在编辑器解析文件前初始化。
- 安装后必须重启 VSCode,不能仅重载窗口(
Developer: Reload Window不够) - 如果项目用了 monorepo 结构(如 pnpm workspace),确保
tsconfig.json或jsconfig.json已存在,否则插件无法推导模块路径 - 检查插件设置里
path-intellisense.mappings是否被手动清空——默认值为空对象{}才能自动探测 - 遇到补全延迟,关掉其他路径类插件(如
Auto Import),它们可能竞争文件监听权
最常被忽略的是 locale.json 和 keybindings.json 的文件位置:前者在 $HOME/.vscode/locales/(Linux/macOS)或 %USERPROFILE%\AppData\Roaming\Code\locales\(Windows),后者在 $HOME/.vscode/keybindings.json;改错文件等于白忙活。











