必须彻底退出VS Code并执行Developer: Reload Window才能使locale.json生效;该文件须严格置于用户级路径(如Windows的%APPDATA%\Code\User\locale.json),内容仅限{"locale":"zh-cn"},且需安装官方中文语言包。

必须彻底退出 VS Code 并点击 Reload Window,否则 locale.json 写对了也白写。
locale.json 文件必须放在用户级路径下
VS Code 只读取特定位置的 locale.json,放错地方就完全不生效:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
别把它塞进 .vscode/ 工作区目录、locales/ 子目录,或用记事本另存为带 BOM 的 UTF-8——VS Code 会静默忽略。用 VS Code 自己新建并保存该文件,能天然避开编码问题。
内容格式有硬性要求,错一个字符都不行
locale.json 不是 settings.json,它只认一个字段,且大小写、符号、空格全敏感:
- 必须是
{"locale":"zh-cn"}(小写zh-cn,不能是zh_CN、zh-CN、zh或Chinese) - 必须用英文双引号,不能用中文引号或单引号
- 不能有多余逗号、空格、注释或换行(JSON 格式要严格合法)
- 文件名必须是
locale.json,不是locale.txt或Locale.json
Reload Window 是唯一生效触发点
改完 locale.json 后,仅保存文件没用,必须让 VS Code 重新加载语言上下文:
- 确保所有 VS Code 进程已退出(检查 Windows 任务管理器里的
Code.exe,macOS 活动监视器里的Electron) - 启动 VS Code,打开任意窗口,按
Ctrl+Shift+P输入Developer: Reload Window并执行 - 千万别只按
Ctrl+R刷新页面,或关掉再重开——只有Reload Window会重建 UI 语言栈
远程环境(如 WSL / Remote-SSH)要单独操作:在远程窗口里执行 Developer: Reload Window,本地 reload 不影响远程实例。
中文语言包未安装会导致配置静默失效
locale.json 设了 "zh-cn",但界面仍是英文?大概率是缺语言包:
- 打开扩展面板(
Ctrl+Shift+X),搜Chinese (Simplified) Language Pack for Visual Studio Code - 确认发布者是
Microsoft,点击 Install - 装完后必须再执行一次
Developer: Reload Window,否则语言包不会激活
Remote-SSH 和 WSL 还得在对应远程机器上单独装这个插件——本地装了,远程照样英文。
最容易被忽略的一点:VS Code 的语言设置不继承终端环境。如果你从 shell 启动(比如 code .),而终端的 $LANG 是 en_US.UTF-8,它可能覆盖 locale.json。建议直接从桌面图标启动,或在终端中先执行 unset LANG LC_ALL 再运行 code。


















