項目中遇到pom文件里使用systemPath，很少見，問了下豆包，記錄下結果。

在 Maven 的?pom.xml?中，<systemPath>?是?<dependency>?標簽內的一個可選配置，用于手動指定本地系統中某個依賴包（通常是 JAR 文件）的絕對路徑。

它主要用于處理那些不存放在 Maven 中央倉庫或私有倉庫中的第三方依賴（比如某些本地自定義的 JAR、非公開的 SDK 等），強制 Maven 使用本地指定路徑的 JAR 文件。

<dependencies><dependency><groupId>com.example</groupId><artifactId>custom-lib</artifactId><version>1.0.0</version><!-- 指定本地 JAR 文件的絕對路徑 --><systemPath>${project.basedir}/lib/custom-lib-1.0.0.jar</systemPath><!-- 必須添加 scope 為 system --><scope>system</scope></dependency>
</dependencies>

注意事項：

1. 必須配合?<scope>system</scope>?使用：只有當依賴的?scope?設為?system?時，systemPath?才會生效。
2. 路徑問題：
   • 建議使用 Maven 內置變量（如?${project.basedir}?表示項目根目錄）構建相對路徑，避免硬編碼絕對路徑（如?C:/libs/xxx.jar），否則會導致項目在其他環境中無法運行。
   • 路徑指向的 JAR 文件必須真實存在，否則會報 “依賴找不到” 的錯誤。
3. 缺點明顯：
   • 破壞 Maven 的依賴管理機制，無法自動下載和更新依賴，需要手動拷貝 JAR 到指定路徑。
   • 團隊協作時，需要所有開發者的本地環境都有相同路徑的 JAR，否則會構建失敗。
   • 不推薦在正式項目中大量使用，優先考慮將依賴安裝到本地倉庫（mvn install:install-file）或私有倉庫。

簡單說，systemPath?是一種 “應急方案”，用于臨時引入本地特殊 JAR，但應盡量避免在生產環境中使用。