1. Tải Apache Maven

Có thể tải Maven từ trang chủ chính thức: Apache Maven. Nên chọn phiên bản 3.5.x để tránh các vấn đề tương thích — một số người dùng báo cáo khó khăn khi cấu hình phiên bản 3.8.x.

Một lựa chọn thay thế là sử dụng liên kết chia sẻ (ví dụ qua Baidu Netdisk), nhưng nên ưu tiên nguồn chính thống để đảm bảo an toàn và ổn định.

2. Giải nén Maven

Sau khi tải về, giải nén file ZIP vào một thư mục dễ nhớ, ví dụ:

E:\dev-tools\apache-maven-3.5.2

Đường dẫn này sẽ được dùng trong bước cấu hình biến môi trường.

3. Thiết lập biến môi trường

1. Mở Hệ thống → Cài đặt nâng cao → Biến môi trường.
2. Trong phần Biến hệ thống, nhấn New và tạo biến mới:
   • Tên biến: MAVEN_HOME
   • Giá trị: E:\dev-tools\apache-maven-3.5.2
3. Chỉnh sửa biến Path, thêm đường dẫn sau:

   %MAVEN_HOME%\bin

4. Kiểm tra cài đặt

Mở Command Prompt và chạy lệnh:

mvn -v

Nếu hiển thị thông tin phiên bản Maven, Java và các chi tiết liên quan thì việc cài đặt đã thành công.

5. Cấu hình tập tin settings.xml

File cấu hình nằm tại: $MAVEN_HOME/conf/settings.xml. Dùng trình soạn thảo văn bản để chỉnh sửa.

5.1. Thiết lập kho lưu trữ cục bộ

Mặc định, Maven lưu dependency tại ~/.m2/repository. Để thay đổi, bỏ comment hoặc thêm dòng sau trong file settings.xml:

<localRepository>E:\maven-repo</localRepository>

5.2. Cấu hình mirror từ Alibaba Cloud

Để tăng tốc độ tải dependency, thêm mirror của Alibaba vào trong thẻ <mirrors></mirrors>:

<mirror>
  <id>aliyunmaven</id>
  <mirrorOf>central</mirrorOf>
  <name>Aliyun Maven</name>
  <url>https://maven.aliyun.com/repository/central</url>
</mirror>

5.3. Thiết lập phiên bản JDK mặc định

Thêm profile sau vào trong thẻ <profiles></profiles> để chỉ định JDK 1.8 làm trình biên dịch mặc định:

<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.release>8</maven.compiler.release>
  </properties>
</profile>