Maven編譯時(shí)出現(xiàn)中文亂碼的完整解決教程
適合：Windows 用戶(hù)、Maven 編譯項(xiàng)目時(shí)終端或 IDEA 出現(xiàn)中文亂碼的人群
錯(cuò)誤示例：
[WARNING] δ?? -source 8 ?????????????·??
或者中文輸出成一堆“亂碼方塊”。
一、為什么會(huì)出現(xiàn)亂碼
這是因?yàn)椋?/p>
- Windows 控制臺(tái)默認(rèn)編碼是 GBK
- Maven（和 Java）輸出使用 UTF-8 編碼
兩者不一致，中文顯示就變成了亂碼。
簡(jiǎn)單說(shuō)：
Maven 說(shuō)中文 → Windows 聽(tīng)不懂。
二、快速解決方法
方法 1：臨時(shí)解決（命令行直接改編碼）
每次運(yùn)行 Maven 前執(zhí)行這條命令：
chcp 65001
然后再執(zhí)行：
mvn clean package
作用：把當(dāng)前 CMD 窗口改成 UTF-8 編碼。
優(yōu)點(diǎn)：立刻生效，不改配置。
缺點(diǎn)：每次都要手動(dòng)執(zhí)行。
方法 2：永久解決（配置 Maven 啟動(dòng)參數(shù)）
讓 Maven 永遠(yuǎn)以 UTF-8 運(yùn)行。
① 打開(kāi) Maven 安裝目錄
路徑一般是：
D:\apache-maven-3.6.3\bin\mvn.cmd
② 在文件頂部加一行：
set MAVEN_OPTS=-Dfile.encoding=UTF-8
保存后關(guān)閉。
③ 驗(yàn)證是否生效：
mvn -v
如果沒(méi)有亂碼，說(shuō)明成功。
方法 3：IDEA 用戶(hù)設(shè)置（推薦）
如果你是在 IntelliJ IDEA 中運(yùn)行 Maven 構(gòu)建：
打開(kāi)：File → Settings → Build, Execution, Deployment → Build Tools → Maven → Runner
在 VM Options 輸入框中添加：
-Dfile.encoding=UTF-8
再打開(kāi)：File → Settings → Editor → File Encodings
全部設(shè)置為 UTF-8
取消 “Transparent native-to-ascii conversion”
方法 4：全局永久生效（推薦高級(jí)玩家）
如果你希望任何時(shí)候打開(kāi)命令行 Maven 都是 UTF-8：
在用戶(hù)目錄（C:\Users\<你的用戶(hù)名>\）下創(chuàng)建一個(gè)文件：
mavenrc_pre.bat
寫(xiě)入內(nèi)容：
chcp 65001 >nul set MAVEN_OPTS=-Dfile.encoding=UTF-8
保存后重啟命令行即可。
三、可選進(jìn)階：防止 XML 文件亂碼
有時(shí)候 Maven 的中文亂碼是因?yàn)榕渲梦募ㄈ?settings.xml 或 pom.xml）編碼不正確。
確保它們都是 UTF-8 無(wú) BOM 格式保存：
VS Code：
右下角點(diǎn)擊編碼 → “另存為編碼” → 選擇 UTF-8
Notepad++：
菜單欄「編碼」→「轉(zhuǎn)換為 UTF-8（無(wú) BOM）」→ 保存
四、總結(jié)表格
| 場(chǎng)景 | 原因 | 解決方案 |
|---|---|---|
| 命令行亂碼 | 控制臺(tái)是 GBK | chcp 65001 |
| Maven 報(bào)亂碼 | 輸出編碼非 UTF-8 | set MAVEN_OPTS=-Dfile.encoding=UTF-8 |
| IDEA 編譯亂碼 | IDEA 未設(shè) UTF-8 | IDEA → Settings → File Encoding → UTF-8 |
| settings.xml 報(bào)錯(cuò) | 文件含 BOM 或全角空格 | 改為 UTF-8（無(wú) BOM）保存 |
結(jié)語(yǔ)
中文亂碼看起來(lái)嚇人，其實(shí)都是 編碼不匹配 導(dǎo)致的。
一句話(huà)記?。?/p>
讓系統(tǒng)、Maven、IDEA 一起說(shuō) UTF-8，世界就清凈了。
到此這篇關(guān)于Maven編譯時(shí)出現(xiàn)中文亂碼的完整解決教程的文章就介紹到這了,更多相關(guān)Maven編譯出現(xiàn)中文亂碼解決方法內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
Java寬化基本類(lèi)型轉(zhuǎn)換與精度丟失詳解(為什么long可以自動(dòng)轉(zhuǎn)float)
java中l(wèi)ong到float的轉(zhuǎn)換屬于自動(dòng)類(lèi)型轉(zhuǎn)換,因?yàn)閒loat的范圍比long更大,這篇文章主要介紹了Java寬化基本類(lèi)型轉(zhuǎn)換與精度丟失的相關(guān)資料,詳細(xì)介紹了為什么long可以自動(dòng)轉(zhuǎn)float,需要的朋友可以參考下2026-05-05
Maven依賴(lài)沖突是?Java?開(kāi)發(fā)中的常見(jiàn)問(wèn)題,很多人遇到后習(xí)慣到處寫(xiě)?exclusion,本文將從?JSqlParser?版本沖突的真實(shí)案例出發(fā),講清楚?Maven?的依賴(lài)仲裁機(jī)制,感興趣的小伙伴可以了解下2025-12-12
解決feign接口返回泛型設(shè)置屬性為null的問(wèn)題
這篇文章主要介紹了解決feign接口返回泛型設(shè)置屬性為null的問(wèn)題，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方，望不吝賜教2021-06-06
SpringBoot啟動(dòng)后的初始化數(shù)據(jù)加載原理解析與實(shí)戰(zhàn)
本文主要圍繞?Spring?Boot?啟動(dòng)后的初始化數(shù)據(jù)加載展開(kāi),介紹了初始化任務(wù)的基本需求,包括全局配置加載、數(shù)據(jù)庫(kù)表初始化等,闡述了多種初始化加載方式,分析了它們的優(yōu)缺點(diǎn),需要的朋友可以參考下2024-11-11
springboot多環(huán)境(dev、test、prod)配置詳解
這篇文章主要介紹了springboot多環(huán)境(dev、test、prod)配置詳解，小編覺(jué)得挺不錯(cuò)的，現(xiàn)在分享給大家，也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧2019-04-04
這篇文章主要介紹了java實(shí)現(xiàn)模擬RPG格斗，每個(gè)英雄具有以下幾個(gè)屬性：生命值（為0時(shí)英雄倒下）、攻擊力（每次攻擊時(shí)扣除對(duì)方的生命值點(diǎn)數(shù)）、攻擊間隔（每次攻擊過(guò)后都要等待間隔時(shí)間才能進(jìn)行下次攻擊首次攻擊之前也要先等待間隔時(shí)間）簡(jiǎn)單設(shè)置了下吧，小伙伴可以參考下2015-03-03
這篇文章主要介紹了Java中兩個(gè)字符串進(jìn)行大小比較,符串是否相等比較，只能使用equals()方法，不能使用“==”，本文通過(guò)示例代碼給大家介紹的非常詳細(xì)，需要的朋友可以參考下2022-12-12
Java中String類(lèi)startsWith方法詳解
這篇文章主要給大家介紹了關(guān)于Java中String類(lèi)startsWith方法的相關(guān)資料,startsWith() 方法用于檢測(cè)字符串是否以指定的前綴開(kāi)始,文中通過(guò)代碼介紹的非常詳細(xì),需要的朋友可以參考下2024-05-05
這篇文章主要介紹了微信支付java版本之獲取Access_token，java如何獲取Access_token，感興趣的小伙伴們可以參考一下2016-08-08
用Java打造簡(jiǎn)易計(jì)算器的實(shí)現(xiàn)步驟
這篇文章主要介紹了如何設(shè)計(jì)和實(shí)現(xiàn)一個(gè)簡(jiǎn)單的Java命令行計(jì)算器程序,該程序能夠執(zhí)行基本的數(shù)學(xué)運(yùn)算（加、減、乘、除）,文中通過(guò)代碼介紹的非常詳細(xì),需要的朋友可以參考下2025-01-01