1. 程式人生 > >【Java】Maven安裝、Eclipse配置以及相關錯誤解決集合

【Java】Maven安裝、Eclipse配置以及相關錯誤解決集合

文件 格式 setting BYD cksum runt 文件編碼 原因 完成後

作者嘔血總結,下面寫的每一個錯誤我都遇過

· Maven安裝

· Eclipse配置

· Maven安裝

安裝前請確保已經裝有JDK。

一、 準備Maven程序包

到官網https://maven.apache.org/download.cgi下載最新版,請註意查看是否符合安裝的要求(頁面System Requirements處)

確認符合條件後可選擇Binary zip包下載,目前最新版的Maven是3.5.4。(Source archive是源碼包)

解壓文件到你指定的目錄,文件結構如圖所示。

技術分享圖片

二、配置環境變量

Win10用戶需要在系統變量區域進行配置。

新建

變量名:MAVEN_HOME

變量值:C:\Program Files\Apache\maven(以上文件所在的目錄)

Path變量增加一項

%MAVEN_HOME%\bin

三、 檢查安裝狀況

win+R - cmd進入窗口輸入mvn -v或mvn-version可得以下類似信息

C:\Users\MYPC>>mvn -v
Apache Maven 3.5.4 (1edded0938998edf8bf061f1ceb3cfdeccf443fe; 2018-06-18T02:33:14+08:00)
Maven home: C:\Program Files\Apache\maven\bin\..
Java version: 1.8.0_121, vendor: Oracle Corporation, runtime: C:\Program Files\Java\jdk1.8.0_121\jre
Default locale: zh_CN, platform encoding: GBK
OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows"

如正常顯示,則安裝完成。

四、配置本地倉庫(Local Repository)

1. 新建文件夾,以此作為本地倉庫位置。現在以我設定的為例。

D:\MavenRepositories

2. 修改settings.xml文件,文件位置位於

C:\Program Files\Apache\maven\conf

使用Notepad++,指定本地倉庫位置

<localRepository>D:/MavenRepositories</localRepository>

3. 我建議在此步驟先不要用mvn help:system命令下載maven包,因為就算此前配置完全成功,這一部分仍然可能未知原因出錯!當然你可先在CMD窗口裏先嘗試一下

mvn help:system

技術分享圖片

如果窗口末端顯示文字BUILD SUCCESS,那麽恭喜你,你已經幸運地完成一大半的任務了。對於運氣不佳的同學(比如我!),就會出現以下問題,如結尾:

No plugin found for prefix ‘help‘ in the current project and in the plugin groups...

(單引號內的單詞會因為情況有所更改)

下載失敗的原因:1. 配置文件settings.xml裏指定的本地倉庫地址有誤;2. 網絡問題無法下載(通常是因為土薔的關系,你懂的)

所以接下來我們要在配置文件中添加鏡像。

阿裏雲的速度其實不太行,我幾乎把各位貼出的地址都試過一遍,update indexes都沒法動起來,或者瞬間100%。以下是我試驗過確實可行的鏡像。(貌似是某位大佬在Nexus上架設的私服,具體操作未知)

在文件中添加如下內容,添加後再使用mvn help:system進行包的下載。

<mirrors>
        <mirror>
            <id>Nexus</id>
            <name>Nexus Public Mirror</name>
            <url>http://121.42.166.202:8081/nexus/content/groups/public</url>
            <mirrorOf>central</mirrorOf>
        </mirror>
<mirros>

同時增加以下內容。其中第一部分profile裏的內容是確保每次新建Maven文件默認使用JDK1.8版本。

<profile>
  <id>jdk-1.8</id>
  <activation>
    <activeByDefault>true</activeByDefault>
    <jdk>1.8</jdk>
  </activation>
  <properties>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
    <maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
  </properties>
</profile>

<profile>
  <id>dev</id>
  <repositories>
    <repository>
      <id>Nexus</id>
      <url>http://121.42.166.202:8081/nexus/content/groups/public</url>
      <releases>
        <enabled>true</enabled>
        <updatePolicy>always</updatePolicy>
        <checksumPolicy>warn</checksumPolicy>
      </releases>
      <snapshots>
        <enabled>true</enabled>
        <updatePolicy>never</updatePolicy>
        <checksumPolicy>fail</checksumPolicy>
       </snapshots>
    </repository>
  </repositories>

  <pluginRepositories>
    <pluginRepository>
      <id>Nexus</id>
      <url>http://121.42.166.202:8081/nexus/content/groups/public</url>
      <releases>
        <enabled>true</enabled>
        <checksumPolicy>warn</checksumPolicy>
      </releases>
      <snapshots>
        <enabled>true</enabled>
        <checksumPolicy>fail</checksumPolicy>
      </snapshots>
     </pluginRepository>
    </pluginRepositories>
    <properties> <environment.type>prod</environment.type> </properties>

</profile>

· Eclipse配置

步驟1:添加剛剛安裝好的Maven

菜單欄Window - Preference - Maven - Installation - Add

技術分享圖片

然後返回剛才的界面,勾選剛剛指定的Maven

技術分享圖片

步驟2:指定你的個人倉庫路徑

Window - Preference - Maven - User Settings,把Global Settings和Local Settings都設置為上述修改的settings.xml的路徑。如果Eclipse提示"Could not read settings.xml",原因如下:

1. 保存文件編碼格式不為UTF-8;

2. settings.xml文件內容出現語法錯誤,通常是標簽漏寫了一項(開始標簽或者結束標簽)。可用瀏覽器模式打開xml文件,如果正確顯示XML內容則無誤,否則會提示錯誤的行數。

技術分享圖片

XML文件以瀏覽器模式閱讀的圖示

步驟3: 為你的Maven插件添加索引(添加依賴時就能在Eclipse裏通過搜索直接獲取包,而無需修改pom.xml文件)

點開Global Repository,選擇Nexus,右擊選上Full Index Enable,隨後選擇Rebuild Index,等待下載完成。

步驟4:勾選Download repository index updates on startup,否則可能在maven插件中無法通過搜索查到依賴

技術分享圖片

· 快速測試

新建Maven Project

技術分享圖片

新建完成後右鍵Maven-Add Dependency(下方的Artifact ID cannot be empty可以選擇無視),即可通過搜索下載依賴包

技術分享圖片

【Java】Maven安裝、Eclipse配置以及相關錯誤解決集合