EasyUI 亂碼問題解決：編碼格式已設置仍偶發亂碼怎麼辦？

問題背景

在使用 EasyUI 開發 Web 應用時，有時會遇到頁面顯示亂碼的情況，即使已經在頁面中設置了編碼格式（如 ``），問題依然偶發。這通常讓開發者感到困惑：明明編碼都對了，為什麼還會亂碼？

核心原因：文件存儲編碼與頁面聲明編碼不一致

亂碼的根本原因在於文件的實際存儲編碼與頁面 meta 標籤聲明的編碼不匹配。常見情況包括：

• JS 文件以 ANSI (GB2312) 格式保存，但頁面聲明為 UTF-8
• 頁面聲明為 GB2312，但引入的 JS 文件實際為 UTF-8 編碼

解決方案

1. 統一編碼格式（推薦）

將所有文件（HTML、JS、CSS、後端模板）統一保存為 UTF-8 無 BOM 格式，並在頁面頭部統一聲明：

<meta charset="utf-8">

現代開發工具（VS Code、IntelliJ IDEA 等）默認均為 UTF-8，建議項目統一規範。

2. 若無法統一，需在 script 標籤指定 charset

當 JS 文件編碼與頁面編碼不一致時，必須在引入腳本時顯式聲明：

<script charset="gb2312" src="xxx.js"></script>

同理，若頁面為 GB2312 而 JS 為 UTF-8，則寫 `charset="utf-8"`。

排查檢查清單

1. 確認頁面 `` 聲明
2. 用編輯器查看報亂碼的 JS/CSS/HTML 文件實際保存編碼
3. 檢查後端響應 Header 中的 `Content-Type` 是否包含正確 charset
4. 若使用框架（如 Spring MVC），確認 `CharacterEncodingFilter` 配置正確

總結

EasyUI 亂碼本質上是編碼不一致導致。最佳實踐是全項目統一 UTF-8，若歷史原因無法統一，則必須在 `