离线环境下必须手动编辑用户级locale.json文件并重启:路径为%APPDATA%\Code\User\locale.json(Win)、~/Library/Application Support/Code/User/locale.json(macOS)或~/.config/Code/User/locale.json(Linux),内容严格为{"locale":"zh-cn"}(UTF-8无BOM),且需确保已离线安装Microsoft官方中文语言包ms-ceintl.vscode-language-pack-zh-hans。

离线环境必须手动编辑 locale.json 文件
离线状态下无法调用命令面板里的 Configure Display Language,也进不了扩展市场下载语言包,唯一可行路径是:先确保中文语言包已通过其他机器拷贝到位,再直接编辑 locale.json 并彻底重启。这步跳过所有 UI 交互,不依赖网络、不依赖命令面板可用性。
常见错误现象包括:改完文件后右下角仍显示 en、菜单栏和设置页全英文、点击状态栏语言标识无反应——90% 是因为没关干净后台进程,或写错了配置路径。
- 必须关闭所有 VS Code 窗口,包括托盘图标(Windows 查任务管理器中是否还有
Code.exe;macOS 用活动监视器查Electron进程) - 只编辑用户级
locale.json,不是settings.json,也不是工作区或远程配置 - 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.json 内容必须严格为一行合法 JSON
这个文件只干一件事:告诉 VS Code 用什么语言渲染界面。它不是 settings.json,不支持注释、不接受多余空格、不能有逗号结尾、不能用单引号。任何格式偏差都会导致静默失败——VS Code 直接忽略该文件,回退到系统语言。
正确内容只有一行,且必须是:
{"locale":"zh-cn"}
容易踩的坑:
- 写成
"locale": "zh_CN"或"locale": "zh-hans"—— 只有zh-cn被主程序硬编码识别 - 保存为 UTF-8 with BOM 编码 —— 必须是 UTF-8 无 BOM,否则读取失败(记事本默认可能带 BOM,推荐用 VS Code 自身或 Notepad++ 保存)
- 误把内容写进
settings.json—— 该字段在那里完全不被解析,纯属无效配置 - 多加了逗号、漏了引号、用了中文标点 —— JSON 格式校验失败,整个文件作废
中文语言包没装好,locale.json 再对也没用
locale.json 只是“开关”,语言包才是“字典”。离线环境下,必须提前在联网机器上下载官方 vscode-language-pack-zh-hans-*.vsix(发布者必须是 MS-CEINTL),再拷贝到目标机器,用命令面板安装(即使离线,只要 VS Code 启动着,命令面板仍可用)。
使用约定式提交(Conventional Commits)生成标准化的 Git 提交信息。适用于以下场景: (1) 暂存更改时需要提交信息; (2) 审查 diff 时希望获得结构化摘要; (3) 编写 PR 描述或变更日志(changelog)条目; (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff,并生成按类型(type)划分范围的提交信息。
如果命令面板打不开,就只能靠手动安装 + 验证:
- 安装后检查扩展面板是否显示
ms-ceintl.vscode-language-pack-zh-hans并标记为“已启用” - 若未启用,说明只是把 .vsix 文件复制进了
~/.vscode/extensions/,但没注册——必须卸载后重走Extensions: Install from VSIX - 确认 VS Code 版本兼容:打开终端执行
code --version,对比 .vsix 文件名中的版本号(如-1.104.2025082016.vsix对应^1.104.0)
改完 locale.json 后必须点 Reload Window,不是关掉重开
很多用户改完保存,弹出「语言已更改,重新加载窗口以应用」提示,却点了叉掉或直接关窗口——这不会生效。Reload Window 是唯一能触发语言资源重加载的操作,它会清空当前 UI 状态并强制从 locale.json 和已启用语言包中重建翻译上下文。
验证是否成功,只看三处:
- 右下角状态栏是否显示
zh-cn(点击它可快速切换) - 菜单栏(File、Edit、View…)是否为中文
- 命令面板(
Ctrl+Shift+P)输入关键词是否显示中文提示
其他区域(比如某些插件的 UI、自定义侧边栏)仍为英文属正常,那是插件自身未做本地化,和 locale.json 无关。










