必须输入完整扩展名“Chinese (Simplified) Language Pack for Visual Studio Code”,认准发布者Microsoft、ID ms-ceintl.vscode-language-pack-zh-hans,安装后须点“Restart Now”并手动配置locale.json为{"locale":"zh-cn"},路径需正确且进程须彻底退出。

搜索时必须输入完整扩展名,不能只搜“中文”
在扩展面板(Ctrl+Shift+X)里搜“Chinese”或“中文”,会混入大量非官方插件,比如 Chinese Language Pack、VSCode Chinese,它们不更新、不兼容,甚至可能覆盖核心翻译资源。真正起效的只有一个:Chinese (Simplified) Language Pack for Visual Studio Code——注意括号、空格、大小写全都要对。
认准发布者是 Microsoft,图标带蓝白 VS 标志,扩展 ID 是 ms-ceintl.vscode-language-pack-zh-hans。这个 ID 会在扩展详情页 URL 或设置中显示,可直接核对。
安装后右下角提示必须点“Restart Now”,不是“Reload Window”
装完插件只是把翻译资源复制进本地,VS Code 不会自动切换语言。右下角弹出的提示里,“Change Language and Restart”或“Restart Now”才是有效操作;点“Reload Window”只会刷新当前窗口,不重读语言配置,界面仍为英文。
如果没弹窗,别等,立刻按 Ctrl+Shift+P 打开命令面板,手动执行:Configure Display Language,然后从列表中选 zh-cn(小写、短横线,不是 zh_CN、zh-hans 或 Chinese)。
locale.json 路径和内容必须严格匹配,不能写错位置或格式
这个文件是语言生效的最终依据,VS Code 启动时优先读它。它默认不存在,需手动创建或由插件生成。路径因系统而异:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
$HOME/Library/Application Support/Code/User/locale.json - Linux:
$HOME/.config/Code/User/locale.json
文件内容只能是标准 JSON,且仅一行:{"locale":"zh-cn"}。多一个空格、少一个引号、用错引号类型(如中文引号)、或写成 zh-CN(大写 C/N),都会导致失效。不要往 settings.json 里加 "locale" 字段——它在那里完全不被识别。
插件没生效?先查进程是否彻底退出
很多“改了 locale.json 还是英文”的问题,根源是 VS Code 后台进程没关干净。Windows 上打开任务管理器,搜 Code.exe,强制结束所有实例;macOS 用活动监视器查 Electron 进程;Linux 可用 pkill -f "code"。再全新启动,右下角状态栏会显示当前语言代码(如 zh-cn),点击它也能快速验证是否加载成功。
真正卡住人的从来不是找不到插件,而是装对了、配对了、但没关干净进程,或者把 locale.json 放错了路径、写错了大小写——这些细节不满足,VS Code 就当它不存在。


















