如何在WebStorm中解决Terminal终端中文乱码问题

梦晨吖_5298

梦晨吖_5298

2026-05-19

688人浏览

原创

webstorm terminal乱码需同步配置系统层(windows注册表设chcp 65001或linux/macos改webstorm.sh导出lang/lc_all)、jvm层(vmoptions和run configuration中均加-dfile.encoding=utf-8)及powershell输出编码(修改$profile设[console]::outputencoding),三者缺一不可。

如何在webstorm中解决terminal终端中文乱码问题

WebStorm 的 Terminal 乱码和编辑器乱码是两套独立机制,只改 File Encodings 没用——Terminal 输出走的是系统 Shell + JVM 启动参数 + WebStorm 自身终端渲染三层逻辑,缺一不可。

Terminal 启动前必须加载 UTF-8 环境变量

Windows 下 GUI 启动的 WebStorm 不会继承命令行的 LANG 或 LC_ALL;macOS/Linux 下即使终端里 echo $LANG 显示 zh_CN.UTF-8,WebStorm 内置 Terminal 仍可能读不到。

  • Linux/macOS:编辑 bin/webstorm.sh,在 #!/bin/sh 下方**紧贴第一行**插入:
export LANG=zh_CN.UTF-8
export LC_ALL=zh_CN.UTF-8
  • Windows:不依赖环境变量,靠注册表强制生效 —— 打开 regedit,定位到 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Command Processor,新建字符串值 Autorun,值设为 chcp 65001(注意空格,不是等号)
  • 改完必须完全退出 WebStorm(包括托盘进程),再重启,否则变量不加载

Run Configuration 和 JVM 层编码要同步设为 UTF-8

Terminal 里手动执行 java -XshowSettings:properties -version 2>&1 | grep file.encoding 查到的 file.encoding 值,必须和 Run 配置里的一致。否则 console.log("中文") 或 System.out.println("中文") 依然乱码。

WebStorm Linux版
WebStorm Linux版

WebStorm 2026.2 Linux tar.gz 安装包,适合在 Linux 桌面环境中搭建现代前端开发与调试工作流。

下载
  • 打开 Run > Edit Configurations
  • 选中你的脚本或服务配置,在 Configuration 标签页的 VM options 输入框填入:-Dfile.encoding=UTF-8(大小写敏感,不能写 utf8)
  • 同时检查 Environment variables 区域是否也显式设置了 file.encoding=UTF-8 —— IDEA 系列常漏这一项
  • 编辑 bin/webstorm64.vmoptions(Windows/macOS)或 webstorm.vmoptions(Linux),追加一行:-Dfile.encoding=UTF-8

Terminal 字体设置不影响编码,但影响中文能否显示出来

如果 Terminal 里中文显示为“□□□”,不是编码错了,而是字体没 fallback 到中文字体;此时改编码无济于事,得调字体。

  • 路径:Settings → Tools → Terminal → Font,不是 Editor 或 Appearance 里的设置
  • 必须勾选 Override IDE font,否则改 Size/Font 没反应
  • 推荐等宽字体:JetBrains Mono、Fira Code、Cascadia Code;禁用 Enable font ligatures 避免模糊
  • 字体大小建议从 14 起调;高分屏可设为 16 或 18
  • 注意:该设置绑定在当前配色方案下,换主题(如 Darcula → Light)后需重新确认是否仍启用 Override IDE font

PowerShell 用户额外注意输出编码

PowerShell v1/v7 默认不按 UTF-8 输出,即使系统设了 chcp 65001,[Console]::OutputEncoding 仍可能是 GBK,导致 Node.js/Java 日志中文被截断或转义。

  • 找到 PowerShell 配置文件:$PROFILE(运行 echo $PROFILE 查路径)
  • 在文件末尾添加:
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$PSDefaultParameterValues['Out-File:Encoding'] = 'utf8'
  • 若用 PowerShell 7,还需加一句启用 tab 补全:Set-PSReadLineKeyHandler -Key Tab -Function MenuComplete
  • 执行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 允许配置生效

真正容易被忽略的是:Terminal 乱码问题从来不是单点故障。它像一条流水线——Shell 启动时没加载 UTF-8 变量,JVM 启动时没传 -Dfile.encoding=UTF-8,PowerShell 运行时没设 [Console]::OutputEncoding,三者只要断一环,中文就卡在半路变成问号或方块。

相关文章

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

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

下载

相关标签:

webstorm 中文乱码

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

相关专题

更多
webstorm怎么放大
webstorm怎么放大

webstorm 提供四种放大代码编辑器的方法:键盘快捷键:ctrl/cmd + plus菜单:查看 > 缩放 > 放大工具栏:缩放按钮鼠标滚轮:按住 ctrl/cmd 滚动。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

1242

8

webstorm闪退怎么解决
webstorm闪退怎么解决

解决 webstorm 闪退问题的步骤:检查更新;重新启动计算机;禁用插件;重置设置;清除缓存;检查防火墙和防病毒软件;重新安装 webstorm;联系支持团队。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

1107

6

webstorm运行不了文件的原因
webstorm运行不了文件的原因

webstorm无法运行文件的原因:node.js 版本不匹配;文件路径错误;环境变量未设置;文件依赖项丢失;权限问题;防火墙拦截;webstorm 插件冲突;webstorm 错误。想了解更多webstorm的相关内容,可以阅读本专题下面的文章。

2024.04.08

3702

12

webstorm调节字体大小
webstorm调节字体大小

可以通过三种方法调整 webstorm 的字体大小:快捷键(windows/linux:ctrl + alt + (+或-);macos:cmd + alt + (+或-))、菜单(文件 > 设置 > 外观与行为 > 外观 > ide 字体大小)、注册表(仅限 windowshkey_current_user\software\jetbrains\webstorm\192.7785.53\options\edit

2024.04.08

1342

13

webstorm创建html的方法
webstorm创建html的方法

webstorm创建html项目分五步:创建新项目并配置 html 设置;添加新 html 文件;编写 html 代码并利用实时预览;预览 html 文件并进行部署;使用模板和 emmet 快捷方式加快开发。想了解更多webstorm的相关内容,可以阅读本专题下面的文章。

2024.04.08

4910

12

webstorm新建文件夹方法
webstorm新建文件夹方法

webstorm新建文件夹方法:在项目视图中导航到目标位置;右键单击并选择“新建”>“文件夹”;输入文件夹名称并单击“确定”。想了解更多webstorm的相关内容,可以阅读本专题下面的文章。

2024.04.08

1295

12

webstorm启动项目方法
webstorm启动项目方法

启动方法:1、打开webstorm:启动 webstorm 应用程序;2、创建或打开项目:创建新项目或打开现有项目;3、配置项目:选择项目类型和解释器,配置其他项目设置;4、开始编码:创建文件并编写代码,webstorm 将自动提供代码功能;5、运行项目:右键单击相关文件并选择“启动文件”或“启动”。

2024.04.08

3593

11

webstorm改中文版
webstorm改中文版

更改方法:打开 webstorm 设置;导航到“appearance & behavior”>“language & fonts”;在“user interface language”中选择“chinese (simplified)”或“chinese (traditional)”;重启 webstorm界面将显示为中文。想了解更多webstorm的相关内容,可以阅读本专题下面的文章。

2024.04.08

4536

13

webstorm和idea有什么区别
webstorm和idea有什么区别

webstorm专为web开发量身定制,提供针对web开发语言的强大功能,而intellij idea是支持多种语言的多功能ide。它们的差异主要在于语言支持、web开发特性、代码导航、调试和测试功能、附加特性。最终选择取决于语言偏好和项目需求。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.09

7508

6

热门下载

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

精品课程

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