便携版VSCode的locale.json路径必须为[安装目录]/data/user-data/User/locale.json，内容仅{"locale":"zh-cn"}（UTF-8无BOM），且需彻底退出所有进程后重启；语言包须通过内置扩展面板安装并启用。
便携版 VSCode 的 locale.json 路径必须严格匹配
VSCode 便携版（Portable Mode）不读取系统级配置，locale.json 放错一层就会失效。它只认 data/user-data/User/locale.json 这个路径，不是 data/User/，也不是 data/settings/，更不是 %APPDATA%\Code\User\locale.json。
常见错误现象：装完中文包、改了 locale.json、重启后状态栏右下角还是显示 en——大概率是路径错了。
- Windows 示例路径：
D:\VSCode-Portable\data\user-data\User\locale.json - macOS 示例路径：
/Applications/Visual Studio Code - Portable.app/Contents/Resources/app/data/user-data/User/locale.json - Linux 示例路径：
/opt/vscode-portable/data/user-data/User/locale.json
如果目录不存在，必须手动创建完整结构，注意大小写：user-data 是连字符，不能写成 userdata 或 User_Data。文件内容仅一行：{"locale":"zh-cn"}，UTF-8 编码、无 BOM、无空格、无多余逗号。
离线安装中文语言包必须走内置扩展面板
便携版不支持双击 .vsix、拖拽安装或 code --install-extension 命令行安装——这些方式会把包复制进 extensions 目录，但不会注册语言资源，界面也不会切换。
正确做法只有这一条路：
- 启动便携版 VSCode
- 按
Ctrl+Shift+X打开扩展面板 - 搜索
Chinese (Simplified) Language Pack for Visual Studio Code - 确认发布者是
Microsoft、ID 是ms-ceintl.vscode-language-pack-zh-hans的那一项 - 点击 Install
装完别点 “Reload Window”，必须彻底退出所有进程（Windows 查任务管理器里是否还有 Code.exe，macOS 查 Activity Monitor 中的 Electron），再重新启动。
为什么填 zh-cn 而不是 zh-hans
VSCode 主程序硬编码识别的是 zh-cn。虽然部分旧版本对 zh-hans 有兼容性支持，但从 v1.95+ 开始，它只加载极少量基础 UI 字符串，设置页、终端、调试视图等关键区域仍为英文。
其他常见错误写法也会被直接忽略：
-
zh_CN（下划线） -
ZH-CN（大写） -
chinese（非标准标识） -
"zh-cn "（末尾带空格）
只要值不严格等于 zh-cn，VSCode 就不会触发语言包加载流程。
装完还是英文？先看状态栏右下角和后台进程
状态栏右下角显示 en，说明 VSCode 没读到有效的 locale.json，或者读到了但值无效。这不是插件没装，而是启动时就决定了语言环境。
排查顺序很关键：
- 确认
data/user-data/User/locale.json存在且内容正确 - 确认扩展面板里
ms-ceintl.vscode-language-pack-zh-hans显示“已启用” - Windows 上用任务管理器杀掉所有
Code.exe；macOS/Linux 执行pkill -f "Code Helper"和pkill -f "Electron" - 再启动，不要跳过“彻底退出”这步——这是便携版最容易被忽略的环节
便携版的所有状态都绑定在 data 目录内，任何残留进程都会复用旧配置，导致新改的 locale.json 和新装的语言包完全不生效。
