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

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

梦晨吖_5298

梦晨吖_5298

发布时间:2026-05-19 17:09:19

|

708人浏览过

|

来源于php中文网

原创

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,三者只要断一环,中文就卡在半路变成问号或方块。

热门AI工具

更多
WorkBuddy

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

DeepSeek

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

讯飞智作

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

豆包大模型

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

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

相关专题

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

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

1242

2024.04.08

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

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

1107

2024.04.08

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

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

3722

2024.04.08

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

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

1362

2024.04.08

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

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

4930

2024.04.08

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

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

1295

2024.04.08

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

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

3613

2024.04.08

webstorm改中文版
webstorm改中文版

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

4556

2024.04.08

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

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

40

2026.10.22

热门下载

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

精品课程

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

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