彻底搞懂VSCode中locale.json的作用

冬萱吖_7723

冬萱吖_7723

2026-09-08

216人浏览

原创

vscode唯一认的界面语言开关是locale.json;自1.70起弃用settings.json中"locale"字段,该文件必须位于用户级目录、内容为严格json格式{"locale":"zh-cn"}且无bom编码,修改后需彻底退出进程并重启。

彻底搞懂vscode中locale.json的作用

locale.json 是 VSCode 唯一认的界面语言开关

VSCode 自 1.70 起就彻底弃用了 settings.json 里的 "locale" 字段,无论你写成 "locale": "zh-cn" 还是 "locale": "en",它都静默忽略——不报错、不警告、也不生效。真正起作用的只有 locale.json 文件,且必须放在用户级配置目录下,VSCode 启动时只读一次这个文件,用里面的值决定加载哪套翻译资源。

locale.json 必须严格满足三个条件才生效

常见失效不是因为没装语言包,而是文件位置、内容或编码错了:

  • 路径必须是用户级:Windows 是 %APPDATA%\Code\User\locale.json,macOS 是 ~/Library/Application Support/Code/User/locale.json,Linux 是 ~/.config/Code/User/locale.json;工作区里放的 .vscode/locale.json 完全不读
  • 内容必须是合法 JSON,仅一行:{"locale":"zh-cn"}(英文同理为 {"locale":"en"});多一个空格、少一个引号、用中文双引号、带 BOM 头,都会导致静默 fallback 到英文
  • 文件权限不能是只读(尤其 WSL 或远程挂载场景),否则 VS Code 写入失败但不提示

Configure Display Language 命令本质就是帮你写对 locale.json

这个命令不是“切换语言”的 UI 操作,而是一个安全写入工具:它会自动检查语言包是否已安装、跳转安装页(如缺失)、定位到正确的用户级路径、写入格式严格的 JSON,并弹出重启提示。手动编辑容易出错,但命令面板打不开、卡死或执行后仍无效时,直接编辑 locale.json 反而是最稳的兜底方式。

注意:Configure Display Language 在 VS Code 1.80+ 版本中已被移除,此时只能手动改 locale.json;命令存在时也必须选 zh-cn(小写、短横线),不是 zh_CNChinesezh-hans

抖音下载器(Node.js)
抖音下载器(Node.js)

抖音无水印视频下载和文案提取工具

下载

远程开发(SSH / WSL)需要独立的 locale.json

本地设了中文,远程窗口还是英文?因为 Remote-SSH 和 WSL 启动的是独立的 VS Code Server 实例,它读取的是远程机器上的 locale.json,和本地完全无关。你需要在远程终端中进入 ~/.vscode-server/data/Machine/xxx/(具体子目录名含哈希)并新建或编辑该路径下的 locale.json,内容同样是 {"locale":"zh-cn"},然后在远程窗口中执行 Developer: Reload Window

别指望本地设置透传过去,也别把本地的 locale.json 复制进远程项目目录——它只会被 vsce 打包误引入,引发构建失败。

最关键的细节常被忽略:VSCode 不会动态监听 locale.json 变化,改完必须彻底退出所有进程(包括托盘图标),再重新启动;任何“热重载”“Ctrl+R”“Reload Window”都不等于真正重启实例。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2023.06.20

3736

8

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

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

2023.07.28

1195

5

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

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

2023.08.03

1518

5

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

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

2023.08.17

9183

11

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

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

2023.09.01

820

4

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

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

2023.09.04

2184

5

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

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

2023.09.14

1409

5

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

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

2023.09.21

3689

3

js生成随机数方法
js生成随机数方法

JavaScript生成随机数的方法,包括使用Math.random()方法生成指定范围内的随机整数、生成随机字符串和生成随机颜色。根据具体需求,可以选择适合的方法来生成随机数,以实现各种功能 。

2023.09.25

2035

5

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程