Maven 倉庫分類全解析：本地、中央、私服與遠程倉庫

Maven 倉庫體系概覽

Maven 倉庫是構件的集中存儲地，任何依賴、插件或項目構建輸出皆稱「構件」。倉庫按位置與性質分為兩大類：

• 本地倉庫：開發機器上的緩存，默認路徑 ${user.home}/.m2/repository。首次執行 Maven 命令時自動創建。
• 遠程倉庫：網絡上的構件服務器，再細分為：
  • 中央倉庫：Maven 官方倉庫，默認地址 https://repo.maven.apache.org/maven2
  • 私服：企業內網搭建的代理倉庫，管理外部依賴、部署內部構件
  • 其他公共遠程倉庫：如 JBoss、Spring 等第三方倉庫

核心機制

1. 構件坐標唯一性：groupId:artifactId:version 確定構件在倉庫中的唯一路徑。
2. 查找順序：本地倉庫 → 遠程倉庫（中央/私服/其他）。遠程找到後下載至本地再使用。
3. 本地倉庫增長：隨項目增多，本地倉庫體積持續增大。
4. 構件可用性：只有安裝到本地倉庫，其他 Maven 項目才能引用。

私服優勢

• 減少外網頻寬，加速構建
• 統一管理第三方依賴版本
• 發布內部項目構件，支援團隊協作
• 提供安全審計與許可證合規檢查

常見配置

修改本地倉庫路徑

編輯 settings.xml（建議備份 M2_HOME/conf/settings.xml 後再修改用戶級配置 ~/.m2/settings.xml）：

<localRepository>/custom/path/repo</localRepository>

在 POM 中添加遠程倉庫

<repositories>
  <repository>
    <id>aliyun</id> <!-- id 必須唯一，若為 central 會覆蓋中央倉庫 -->
    <url>https://maven.aliyun.com/repository/public</url>
  </repository>
</repositories>

最佳實踐

• 優先使用私服代理中央倉庫
• 鎖定依賴版本，避免 SNAPSHOT 污染
• 定期清理本地倉庫無用構件
• 配置鏡像加速下載

掌握倉庫分類與配置，能顯著提升構建穩定性與團隊協作效率。