phpstorm项目必须全局设为utf-8编码：global/project encoding均设utf-8，勾选transparent native-to-ascii conversion；批量convert files to utf-8而非仅set encoding；html/php中meta与header须声明utf-8；terminal和database也需设utf-8；.idea/encodings.xml可提交确保团队一致。

PHPStorm 项目默认字符集必须设为 UTF-8，否则中文文件名、注释、数据库字段值等极易出现乱码，且该设置不能仅靠单个文件编码临时切换解决。

确认并修改全局默认编码（影响新创建的文件）

PHPStorm 的「Default encoding」控制新建文件的初始编码，它独立于已有文件的实际编码。很多人只改了当前文件编码（File → File Encoding），却没动这里，导致后续新建的 PHP/HTML/JS 文件仍用系统默认（如 GBK）。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

• 打开 Settings / Preferences → Editor → File Encodings
• 将 Global Encoding 和 Project Encoding 都设为 UTF-8
• 关键：勾选 Transparent native-to-ascii conversion（尤其对 properties 文件必需）
• 不要改动 Default encoding for properties files —— 它应保持为 ISO-8859-1，否则会导致 .properties 文件读取异常

批量重编码已存在文件（避免手动逐个改）

项目里已有大量文件可能是 GBK 或 ANSI 编码，直接改 Project Encoding 不会自动转码，必须显式执行转换，否则编辑时仍会提示「encoding mismatch」或显示方块。

• 在项目根目录右键 → Reload project from disk（先确保文件未被意外缓存）
• 再右键 → Convert Files to UTF-8（注意不是「Set encoding」）
• 弹窗中勾选 Convert encoding of file content，并确认源编码（如选 GBK）
• 慎用「Recursively」—— 若含第三方库（如 vendor 下的 Composer 包），跳过它们，只处理 app/、src/、resources/ 等自有目录

让 PHPStorm 正确识别 HTML/PHP 文件中的 meta charset

即使文件本身是 UTF-8，若 HTML 里写了 <meta charset="gbk"> 鎴

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！