vs code 1.80+ 必须手动创建或修改用户级 locale.json 文件(路径因系统而异),内容严格为 {"locale":"zh-cn"}(utf-8无bom、小写短横线、无空格/逗号/中文符号),并彻底退出进程后重启才生效。

locale.json 文件不存在或路径不对
VS Code 1.80+ 默认不生成 locale.json,直接搜文件名可能找不到。它只在你执行过 Configure Display Language 命令后才被创建;没执行过就手动建,否则改了也白改。
必须确认路径准确:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
$HOME/Library/Application Support/Code/User/locale.json - Linux:
$HOME/.config/Code/User/locale.json
别去 settings.json 里加 "locale" —— 它对界面语言完全无效,VS Code 根本不读这个字段。
locale.json 内容格式错一个字符就失效
{"locale":"zh-cn"} 是唯一合法写法。常见错误包括:
- 写成
zh_CN、ZH-CN、zh-hans、Chinese—— 全部静默失败,界面照旧英文 - 多加空格:
{"locale": "zh-cn"}(冒号后有空格)或{"locale":"zh-cn" }(末尾空格)—— 某些版本会拒绝解析 - 用了中文引号、全角符号、BOM 头 —— 必须 UTF-8 无 BOM,所有标点为英文半角
- 写成
{"locale":"zh-cn",}(末尾逗号)—— JSON 不合法,VS Code 启动时忽略整个文件
改完 locale.json 还是英文?进程没杀干净
VS Code 只在**进程启动时读一次 locale.json**。只要后台还有 Code.exe(Windows)、Electron 或 Code Helper(macOS)、code(Linux)在跑,新配置就永远不会加载。
用于端到端视频本地化流程的轻量编排器,路由至四个专注子技能——/wjs-transcribing-audio、/wjs-translating-subtitles...
务必执行:
- Windows:打开任务管理器 → 结束所有
Code.exe进程 - macOS:打开活动监视器 → 搜索并强制退出
Electron和Code Helper - Linux:终端运行
pkill -f "code.*--no-sandbox"或手动查杀ps aux | grep code
重启不是点「重新加载窗口」,是彻底关闭再双击图标或命令行输入 code 启动。
验证是否真生效,别信终端或 Git 输出
终端、调试控制台、Git 日志、部分插件界面显示英文,跟 locale.json 没关系——它们用的是系统语言或运行时环境变量,不是 VS Code 的界面本地化逻辑。
真正该盯的三个地方:
- 顶部菜单栏文字(“文件”“编辑”“视图”等)
- 左侧活动栏 hover 提示(“资源管理器”“搜索”“Git”等)
- 设置里搜索
locale,看用户设置中locale项值是否为"zh-cn"
这三处全中文,才是 locale.json 生效的铁证。其他地方英文,不是你配错了。










