CentOS 下 PhpStorm 编码设置与乱码排查
一 全局与项目编码设置
- 打开设置：依次点击 File → Settings → Editor → File Encodings（macOS 为 Preferences）。
- 推荐将以下三项统一为 UTF-8：
- IDE Encoding：影响整个 IDE 的默认编码。
- Project Encoding：影响当前项目的默认编码。
- Default encoding for properties files：影响 .properties 文件的默认编码。
- 若项目历史文件为其他编码（如 GBK），可勾选 Override default encoding for project’s roots 为特定目录或文件单独指定编码，避免全局改动引发批量乱码。
- 应用设置后，必要时执行 File → Reload Project from Disk 或重启 IDE 以生效。
二 单个文件与属性文件的特殊处理
- 针对单个文件乱码：在项目视图中右键该文件 → File Encoding，选择正确编码（如 GBK/UTF-8），并选择是否 Reload/Convert 文件内容。
- 对于 .properties 文件：
- 建议保持 UTF-8，并勾选 Transparent native-to-ascii conversion，这样中文会以 Unicode 转义序列 保存，跨平台显示一致。
- 若必须与旧系统兼容而使用 ISO-8859-1/GBK，请确保团队统一配置与工具链支持。
三 HTML 与 HTTP 层面的编码
- 前端页面请在
<head> 中明确声明：
<meta charset="UTF-8">（HTML5 推荐写法）。- 如需兼容老旧浏览器，也可使用：
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">。
- 确保 Web 服务器（如 Nginx/Apache）返回的 Content-Type 响应头包含 charset=utf-8，避免浏览器以错误编码解析。
四 CentOS 终端与工具链一致性
- 确认系统及终端使用 UTF-8：
- 查看/设置环境变量：
echo $LANG $LC_CTYPE；必要时在 shell 配置（如 ~/.bashrc 或 /etc/profile）中导出：
export LANG=zh_CN.UTF-8
export LC_CTYPE=zh_CN.UTF-8
- 如使用 Vim 查看/编辑文件，建议在 /etc/vimrc 或用户 ~/.vimrc 中加入：
set encoding=utf-8
set termencoding=utf-8
- 远程工具（如 PuTTY/Xshell）会话编码请选择 UTF-8，避免终端显示与编辑器不一致。
五 常见场景与排查清单
- 新项目：将 IDE/Project/Properties 统一设为 UTF-8，从源头避免乱码。
- 历史项目含 GBK：优先尝试在 PhpStorm 中按文件或目录 Reload as UTF-8；若已出现乱码，先备份，再以正确编码重新打开并保存。
- 仅个别文件异常：对该文件使用右键 File Encoding 指定正确编码并选择 Reload/Convert。
- 前端页面乱码：检查 与服务器返回的 Content-Type 是否一致为 UTF-8。
- 终端/远程显示乱码：核对 LANG/LC_CTYPE、终端编码与远程工具编码均为 UTF-8。
