讲师中心 微信公众号
AI工具推荐 视频效率加速

详解VSCode中locale.json的生成与配置步骤

小敏君_7965

小敏君_7965

发布时间:2026-10-25 09:09:39

|

490人浏览过

|

来源于php中文网

原创

VSCode 中文界面生效的唯一路径是正确生成并写入 locale.json 文件。必须通过命令面板执行 Configure Display Language 并选 zh-cn 后重启,手动编辑需确保路径、编码、JSON 格式严格正确,Remote-SSH/WSL 需单独配置对应 locale.json。

详解vscode中locale.json的生成与配置步骤

VSCode 中文界面不生效,90% 是因为 locale.json 没生成、没写对、或没被读到——它不是可选项,而是唯一生效路径。

为什么 Configure Display Language 命令是首选入口

这个命令不是“切换语言”的快捷方式,而是 VS Code 唯一受信的配置写入机制:它会自动检查中文语言包是否已安装、跳转补装、并精准写入 locale.json 到用户数据目录。手动编辑文件容易路径错、编码错、JSON 格式错,而命令面板能绕过这些细节,只要插件装对、输入准确,就能一次到位。

  • 必须用 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS)呼出命令面板,Ctrl+P 不行
  • 输入时要完整拼写 Configure Display Language,缩写如 config lang 可能匹配不到
  • 下拉列表中出现的 zh-cn 是唯一合法值;zh_CN、zh-hans、Chinese (Simplified) 都不会触发写入,且无任何错误提示
  • 选中后弹出的提示必须点 Restart,点 Reload Window 不会重读 locale.json

locale.json 文件路径与内容必须严格匹配

VS Code 启动时只读取用户级 locale.json,且只在启动瞬间加载一次。路径错、文件不存在、内容多一个空格,都会静默退回到英文。

Json Repair Kit
Json Repair Kit

使用 Node.js 评估修复格式错误的 JSON,自动纠正尾随逗号、单引号、未加引号的键等常见问题,实现文件规范化。

下载
  • Windows 路径:%APPDATA%\Code\User\locale.json(等价于 %USERPROFILE%\AppData\Roaming\Code\User\locale.json)
  • macOS 路径:$HOME/Library/Application Support/Code/User/locale.json
  • Linux 路径:$HOME/.config/Code/User/locale.json
  • 文件内容必须且仅有一行:{"locale":"zh-cn"}(双引号、小写、连字符、无 BOM、无换行、无逗号)
  • 不要用记事本保存,务必用 VS Code 自己新建并保存为 UTF-8 无 BOM 编码

命令失效时如何手动兜底

当命令面板卡死、输不了字、执行后无反应,或选了 zh-cn 重启仍英文,说明 VS Code 没成功写入配置——此时直接编辑 locale.json 是最稳解法,但前提是进程彻底退出。

  • Windows:打开任务管理器,结束所有 Code.exe 进程(包括后台服务)
  • macOS:活动监视器中结束 Code Helper 和 Electron 进程
  • Linux:运行 pkill -f "code.*--no-sandbox" 或逐个 kill 相关进程
  • 确认托盘图标已消失,再打开对应路径的 locale.json,清空内容,粘贴 {"locale":"zh-cn"} 并保存
  • 全新启动 VS Code,不要从旧窗口 “重新打开”

Remote-SSH / WSL 环境需单独配 locale.json

本地设了中文,远程连接后仍是英文?因为 Remote-SSH 和 WSL 启动的是独立的 VS Code Server 实例,它读取的是远程机器上的 locale.json,和本地完全无关。

  • 在 WSL 终端中进入:~/.vscode-server/data/Machine/(后面可能带哈希后缀的子目录)
  • 在该目录下新建或编辑 locale.json,内容仍为:{"locale":"zh-cn"}
  • 保存后,在远程窗口中执行 Developer: Reload Window(不是 reload 本地窗口)
  • 注意:远程环境无需再装中文语言包插件,Server 复用本地插件资源,但 locale.json 必须单独存在

真正容易被忽略的是:右下角状态栏显示 en 或设置页仍是英文,往往不是配置写错了,而是旧进程还在后台跑着,或者你改的是 settings.json 而不是 locale.json——后者才是 VS Code 唯一认的语言开关。

热门AI工具

更多
Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

4516

2023.06.20

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1375

2023.07.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1798

2023.08.03

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

10063

2023.08.17

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

980

2023.09.01

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2824

2023.09.04

Js中concat和push的区别
Js中concat和push的区别

Js中concat和push的区别:1、concat用于将两个或多个数组合并成一个新数组,并返回这个新数组,而push用于向数组的末尾添加一个或多个元素,并返回修改后的数组的新长度;2、concat不会修改原始数组,是创建新的数组,而push会修改原数组,将新元素添加到原数组的末尾等等。本专题为大家提供concat和push相关的文章、下载、课程内容,供大家免费下载体验。

1589

2023.09.14

js截取字符串的方法介绍
js截取字符串的方法介绍

JavaScript字符串截取方法,包括substring、slice、substr、charAt和split方法。这些方法可以根据具体需求,灵活地截取字符串的不同部分。在实际开发中,根据具体情况选择合适的方法进行字符串截取,能够提高代码的效率和可读性 。

4829

2023.09.21

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

60

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn