必须用 locale.json,因为 VS Code 自1.70起已废弃 settings.json 中的 "locale" 字段;locale.json 是启动时最先加载的语言入口,仅用户级路径下有效,内容须为 {"locale":"zh-cn"} 且 UTF-8 无 BOM 编码。

VSCode 界面切中文,locale.json 是唯一真正起效的配置文件;装插件、改 settings.json、点右下角状态栏都只是辅助手段,不写对 locale.json 就一定不会变中文。
为什么必须用 locale.json,而不是 settings.json
settings.json 里加 "locale": "zh-cn" 完全无效——VS Code 自 1.70 版本起已废弃该字段,既不报错也不读取。只有 locale.json 中的 locale 字段会被识别,且它只存在于用户级路径下,工作区或插件目录里的同名文件一律被忽略。
-
locale.json是 VS Code 启动时最先加载的语言上下文入口,决定命令面板、设置页、菜单栏等所有本体 UI 的语言 - 它不支持注释、不接受多余字段(哪怕多一个逗号)、不兼容全角引号或空格
- 如果文件存在但格式非法,VS Code 会静默回退到英文,且不提示任何错误
locale.json 的路径和内容必须严格匹配
路径错、文件名错、编码错、大小写错,任意一项出问题都会导致配置失效。Windows/macOS/Linux 三端路径不同,但结构一致:用户数据目录 → Code/User/ → locale.json。
将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。
- Windows:
%APPDATA%\Code\User\locale.json(即C:\Users\用户名\AppData\Roaming\Code\User\locale.json) - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json - 文件内容只能是这一行:
{"locale":"zh-cn"}(小写、短横线、双引号、无空格、无 BOM) - 务必用 VS Code 自己新建并保存该文件,避免记事本或第三方编辑器写入 BOM
Remote-SSH / WSL 下 locale.json 要单独配
本地设好了 locale.json,连上远程机器后仍是英文?不是配置失败,而是 Remote-SSH 和 WSL 启动的是独立的 VS Code Server 实例,它读取的是远程机器上的 locale.json,和本地完全无关。
- Remote-SSH 连接后,按
Ctrl+Shift+P运行Developer: Open User Data Folder,进User/目录新建或编辑locale.json - WSL 中先执行
code --list-extensions确认 Server 已启动,再进入~/.vscode-server/data/Machine/xxx/User/locale.json(xxx 是哈希后缀) - 远程端的语言包也得单独安装,本地插件不会自动同步过去
常见静默失败原因:编码、进程、权限
最让人抓狂的是“明明写了,就是不生效”,往往卡在这三个细节上:
-
locale.json必须是 UTF-8 无 BOM 编码;用 VS Code 新建文件并保存,默认就是合规的 - 必须彻底退出所有 VS Code 进程:Windows 查任务管理器杀光
Code.exe,macOS 在活动监视器中结束Electron和Code Helper - 路径中不能含中文字符或空格(比如
C:\我的软件\Code\User\locale.json会被跳过) - 文件名必须是
locale.json,Locale.json(大小写)、locale.json.bak、locale.txt都不识别
真正容易被忽略的,是那个看似微小的编码细节:UTF-8 无 BOM 是硬性前提,哪怕只多一个不可见字节,VS Code 就直接放弃读取,连日志都不打——它选择沉默,而不是报错。

















