Maven 下載 JAR 源碼與 Javadoc 三種姿勢

讓 IDE 顯示依賴源碼與文檔，告別「Source not found」

Maven 專案中查看第三方庫源碼、Javadoc 的三種標準方式，覆蓋命令行、全局配置、IDE 設置，總有一款適合你。

方式一：命令行臨時下載（推薦臨時需求）

# 進入 pom.xml 目錄執行
mvn dependency:sources           # 下載源碼
mvn dependency:resolve -Dclassifier=javadoc  # 下載 Javadoc

注意：部分庫未發布源碼/Javadoc，命令會跳過。

方式二：全局 settings.xml 永久生效（推薦團隊統一）

編輯 ~/.m2/settings.xml：

<profiles>
  <profile>
    <id>downloadSources</id>
    <properties>
      <downloadSources>true</downloadSources>
      <downloadJavadocs>true</downloadJavadocs>
    </properties>
  </profile>
</profiles>
<activeProfiles>
  <activeProfile>downloadSources</activeProfile>
</activeProfiles>

後續 mvn compile 或 IDE 刷新 Maven 專案自動下載。

方式三：Eclipse/IntelliJ IDEA 圖形化設置（最直觀）

• Eclipse：Window → Preferences → Maven 勾選 Download Artifact Sources 和 Download Artifact JavaDoc
• IntelliJ IDEA：Settings → Build Tools → Maven 勾選 Download sources / Download documentation

避坑提示

• 修改 settings.xml 後需 重新導入/刷新 Maven 專案 生效
• 公司內網 Nexus/Artifactory 代理倉庫需確認已緩存 source/javadoc artifact
• 源碼包命名規範：artifactId-version-sources.jar，Javadoc：artifactId-version-javadoc.jar