ubuntu phpstorm为何乱码

在 Ubuntu 下使用 PhpStorm 出现乱码，通常不是 PhpStorm 本身坏了，而是系统字体、编码、JDK 渲染或文件编码的问题。下面按常见原因给你一套排查和解决思路。

一、最常见原因：字体不支持中文

现象

• 菜单、编辑器、终端中文变成方块、问号、乱码
• 英文正常，中文异常

解决方法

1. 安装中文字体

sudo apt install fonts-noto-cjk
# 或
sudo apt install fonts-wqy-zenhei

2. PhpStorm 设置字体

• File → Settings → Editor → Font
• 勾选 Show only monospaced fonts
• 字体选择：
  • Noto Sans Mono CJK SC
  • 或 WenQuanYi Zen Hei Mono

3. UI 字体（重要）

• Help → Edit Custom VM Options
• 添加或修改：

-Dfile.encoding=UTF-8

重启 PhpStorm

二、文件编码不是 UTF-8

现象

• 打开已有 PHP 文件中文乱码
• 新文件正常

解决

1. 右下角编码栏 → 改成 UTF-8
2. File → Settings → Editor → File Encodings
   • Global Encoding: UTF-8
   • Project Encoding: UTF-8
   • Default encoding for properties files: UTF-8
3. 对已有乱码文件：
   • 先确认原编码（GBK？）
   • File → Reload in Encoding → GBK
   • 再 Convert to UTF-8

三、JDK / 环境变量问题（Ubuntu 特有）

现象

• 启动时报编码警告
• 终端输出中文乱码

解决

编辑：

~/.bashrc

确认包含：

export LANG=zh_CN.UTF-8
export LC_ALL=zh_CN.UTF-8

然后：

source ~/.bashrc

四、PhpStorm 内置终端乱码

解决

• Settings → Tools → Terminal
• Shell path 改为：

/bin/bash -l

• 确保终端本身正常：

locale

应显示 UTF-8

五、Wayland / 显卡渲染问题（较少见）

如果是：

• 字体发虚
• 偶发乱码

可尝试：

export GDK_BACKEND=x11

或在 VM Options 加：

-Dsun.java2d.uiScale=1.0

六、快速自检清单 ✅

• [ ] 系统已安装 CJK 字体
• [ ] PhpStorm 使用 UTF-8
• [ ] 字体支持中文
• [ ] locale 是 UTF-8
• [ ] 终端正常

如果你愿意，可以告诉我：

• Ubuntu 版本（22.04 / 24.04？）
• PhpStorm 版本
• 乱码出现位置（编辑器 / 菜单 / 终端 / 弹窗）

我可以给你更精确的配置。