適合：Windows 用戶、Maven 編譯項目時終端或 IDEA 出現(xiàn)中文亂碼的人群

錯誤示例：

[WARNING] δ?? -source 8 ?????????????·??

或者中文輸出成一堆“亂碼方塊”。

一、為什么會出現(xiàn)亂碼

這是因為：

• Windows 控制臺默認(rèn)編碼是 GBK
• Maven（和 Java）輸出使用 UTF-8 編碼

兩者不一致，中文顯示就變成了亂碼。

簡單說：

Maven 說中文 → Windows 聽不懂。

 二、快速解決方法

方法 1：臨時解決（命令行直接改編碼）

每次運行 Maven 前執(zhí)行這條命令：

chcp 65001

然后再執(zhí)行：

mvn clean package

作用：把當(dāng)前 CMD 窗口改成 UTF-8 編碼。

優(yōu)點：立刻生效，不改配置。

缺點：每次都要手動執(zhí)行。

方法 2：永久解決（配置 Maven 啟動參數(shù)）

讓 Maven 永遠(yuǎn)以 UTF-8 運行。

① 打開 Maven 安裝目錄

路徑一般是：

D:\apache-maven-3.6.3\bin\mvn.cmd

② 在文件頂部加一行：

set MAVEN_OPTS=-Dfile.encoding=UTF-8

保存后關(guān)閉。

③ 驗證是否生效：

mvn -v

如果沒有亂碼，說明成功。

方法 3：IDEA 用戶設(shè)置（推薦）

如果你是在 IntelliJ IDEA 中運行 Maven 構(gòu)建：

打開：File → Settings → Build, Execution, Deployment → Build Tools → Maven → Runner

在 VM Options 輸入框中添加：

-Dfile.encoding=UTF-8

再打開：File → Settings → Editor → File Encodings

全部設(shè)置為 UTF-8

取消 “Transparent native-to-ascii conversion”

方法 4：全局永久生效（推薦高級玩家）

如果你希望任何時候打開命令行 Maven 都是 UTF-8：

在用戶目錄（C:\Users\<你的用戶名>\）下創(chuàng)建一個文件：

mavenrc_pre.bat

寫入內(nèi)容：

chcp 65001 >nul
set MAVEN_OPTS=-Dfile.encoding=UTF-8

保存后重啟命令行即可。

三、可選進(jìn)階：防止 XML 文件亂碼

有時候 Maven 的中文亂碼是因為配置文件（如 settings.xml 或 pom.xml）編碼不正確。

確保它們都是 UTF-8 無 BOM 格式保存：

VS Code：

右下角點擊編碼 → “另存為編碼” → 選擇 UTF-8

Notepad++：

菜單欄「編碼」→「轉(zhuǎn)換為 UTF-8（無 BOM）」→ 保存

四、總結(jié)表格

結(jié)語

中文亂碼看起來嚇人，其實都是 編碼不匹配 導(dǎo)致的。

一句話記?。?/p>

讓系統(tǒng)、Maven、IDEA 一起說 UTF-8，世界就清凈了。

到此這篇關(guān)于Maven編譯時出現(xiàn)中文亂碼的完整解決教程的文章就介紹到這了,更多相關(guān)Maven編譯出現(xiàn)中文亂碼解決方法內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論