温馨提示×

debian phpstorm中文乱码咋办

小樊
38
2026-10-11 11:28:00
栏目: 编程语言

在 Debian 下使用 PhpStorm 出现中文乱码,通常是字体、JDK、系统语言环境的问题。可以按下面一步一步排查和解决。


一、确认系统语言环境(很重要)

在终端执行:

locale

正常应类似:

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

如果不是,执行:

sudo dpkg-reconfigure locales

勾选:

  • zh_CN.UTF-8
  • en_US.UTF-8

然后设置为默认。


二、安装中文字体(最常见原因)

Debian 默认可能没装中文字体。

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

安装后重启 PhpStorm。


三、PhpStorm 设置字体

  1. 打开 PhpStorm
  2. File → Settings → Editor → Font
  3. 字体选择:
    • Noto Sans CJK SC
    • 或 WenQuanYi Zen Hei
  4. 取消「Use default font」

四、修改 PhpStorm JVM 字体配置(关键)

编辑 PhpStorm 的 JVM 参数:

~/.config/JetBrains/PhpStorm*/phpstorm64.vmoptions

或启动脚本目录下 phpstorm.vmoptions

添加:

-Dfile.encoding=UTF-8
-Dsun.jnu.encoding=UTF-8

保存后重启。


五、确认 PhpStorm 使用系统 JDK(或正确 JBR)

如果乱码仍在:

phpstorm.sh

启动前执行:

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

或直接在 .bashrc 里加。


六、终端 / 文件内容乱码区分

  • 界面乱码 → 字体问题(已解决)
  • 文件内容乱码 → 文件编码不是 UTF-8
    File → File Encoding → 设为 UTF-8

七、快速自检清单 ✅

  • [ ] locale 是 UTF-8
  • [ ] 装了中文字体
  • [ ] PhpStorm 字体支持中文
  • [ ] JVM 参数有 UTF-8
  • [ ] 文件本身是 UTF-8

如果你愿意,可以告诉我:

  • Debian 版本(如 11 / 12)
  • PhpStorm 版本
  • 是界面乱码还是代码乱码

我可以给你更精准的方案。

0 踩