IntelliJ IDEA 配置 Maven 並設定阿里雲鏡像與本地倉庫路徑

IntelliJ IDEA 配置 Maven 並設定阿里雲鏡像與本地倉庫路徑

本文詳細說明如何修改 Maven 的 settings.xml 配置檔以新增阿里雲鏡像、變更本地倉庫儲存位置，以及在 IntelliJ IDEA 中指定 Maven 設定檔與倉庫路徑。

一、修改 Maven 全域設定檔 (settings.xml)

路徑：{Maven安裝目錄}/conf/settings.xml

1. 新增鏡像配置

找到 <mirrors> 節點，在其中加入以下內容以啟用阿里雲、中央倉庫備用鏡像：

<mirror>
  <id>alimaven</id>
  <name>aliyun maven</name>
  <url>https://maven.aliyun.com/nexus/content/groups/public/</url>
  <mirrorOf>central</mirrorOf>
</mirror>
<mirror>
  <id>repo2</id>
  <mirrorOf>central</mirrorOf>
  <name>Human Readable Name for this Mirror.</name>
  <url>https://repo2.maven.org/maven2/</url>
</mirror>
<mirror>
  <id>ui</id>
  <mirrorOf>central</mirrorOf>
  <name>Human Readable Name for this Mirror.</name>
  <url>https://uk.maven.org/maven2/</url>
</mirror>

2. 變更本地倉庫路徑

預設倉庫位於 C 槽 ~/.m2/repository，建議移至其他磁碟節省空間。找到 <localRepository> 節點，取消註解並修改路徑：

<localRepository>F:\Program Files\Java\maven_repository</localRepository>

• （1）為預設儲存路徑
• （2）為修改後的自訂路徑

二、IntelliJ IDEA 中配置 Maven

1. 開啟 File → Settings (Windows) 或 IntelliJ IDEA → Preferences (macOS)
2. 依序展開：Build, Execution, Deployment → Build Tools → Maven
3. 設定項目：
   • Maven home directory： 指向 Maven 安裝目錄 (如 F:\Program Files\Java\apache-maven-3.3.9)
   • Settings file： 勾選 Override，指向修改後的 settings.xml
   • Local repository： 勾選 Override，指向自訂倉庫路徑

提示： 修改完成後點擊 Apply/OK，IDEA 會自動重新索引 Maven 專案，下載依賴時將使用阿里雲鏡像，速度顯著提升。