Cài đặt danh sách (Phải làm theo thứ tự!)

Công cụ	Mục đích	Phiên bản khuyến nghị	Lệnh kiểm tra
JDK	Môi trường Java	JDK 8/11	java -version
Maven	Công cụ xây dựng dự án	3.6.3+	mvn -v
IDEA	Môi trường phát triển	2021.3+	-
Git	Quản lý phiên bản	2.33.0+	git --version
Postman	Công cụ kiểm thử API	9.0+	-

Các bước cài đặt chi tiết (Bao gồm sự khác biệt giữa Windows/Mac)

1. Cài đặt JDK (Ví dụ với JDK 11)

Windows:

1. Tải gói cài đặt exe từ trang chủ
2. Chạy cài đặt (đường dẫn đề xuất C:\Java\jdk-11.0.xx)
3. Cấu hình biến môi trường:

   # Thêm biến hệ thống
   JAVA_HOME = C:\Java\jdk-11.0.xx
   # Thêm vào Path
   %JAVA_HOME%\bin

Mac:

# Sử dụng Homebrew để cài đặt
brew tap adoptopenjdk/openjdk
brew install adoptopenjdk11

# Kiểm tra
/usr/libexec/java_home -V

2. Cài đặt Maven (Cấu hình kho lưu trữ tốc độ cao)

Bước chung:

1. Tải gói Binary zip từ trang chủ
2. Giải nén vào đường dẫn cục bộ (ví dụ D:\DevTools\apache-maven-3.9.0)
3. Cấu hình biến môi trường:

   MAVEN_HOME = D:\DevTools\apache-maven-3.9.0
   # Thêm vào Path
   %MAVEN_HOME%\bin

4. Cấu hình quan trọng: Sửa file conf/settings.xml:

   <!-- Thêm kho lưu trữ của Alibaba Cloud -->
   <mirror>
     <id>aliyunmaven</id>
     <mirrorOf>*</mirrorOf>
     <name>Kho lưu trữ công cộng Alibaba Cloud</name>
     <url>https://maven.aliyun.com/repository/public</url>
   </mirror>

3. Cài đặt IDEA (Cài đặt tối ưu cho phiên bản 2023)

1. Cài đặt và chọn:
   • Add launchers dir to the PATH
   • .java liên kết
2. Cài đặt lần đầu:

   File → Settings → Build → Build Tools → Maven
   Sửa: Maven home path (chỉ đến thư mục cài đặt)
   Sửa: User settings file (chỉ định file settings.xml đã sửa)

3. Cài đặt plugin:
   • Spring Boot Assistant (bắt buộc)
   • Lombok (giản hóa mã)
   • Maven Helper (giải quyết xung đột phụ thuộc)

4. Kiểm tra môi trường Spring Cloud

Tạo dự án kiểm tra:

// Truy cập https://start.spring.io để tạo dự án
Chọn dependency: Spring Web, Eureka Server

Kiểm tra file pom.xml có chứa:

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-dependencies</artifactId>
    <version>2021.0.8</version>
    <type>pom</type>
    <scope>import</scope>
</dependency>

Hướng dẫn khắc phục lỗi (Bắt buộc phải đọc!)

Tình trạng lỗi	Phân tích nguyên nhân	Giải pháp
JAVA_HOME not found	Cấu hình biến môi trường sai	Kiểm tra khoảng trắng và ký tự đặc biệt trong đường dẫn
Could not find artifact	Kho Maven không hiệu lực	Kiểm tra file settings.xml đã được áp dụng
Port 8080 already in use	Cổng bị chiếm dụng	Sử dụng netstat -ano để tìm và kết thúc tiến trình
Bean creation error	Xung đột phiên bản Spring Boot	Đồng bộ hóa số phiên bản trong pom cha

Script cài đặt tự động (Chỉ dành cho Linux/Mac)

#!/bin/bash
# Cài đặt JDK
brew install adoptopenjdk11

# Cài đặt Maven
wget https://dlcdn.apache.org/maven/maven-3/3.9.0/binaries/apache-maven-3.9.0-bin.tar.gz
tar -xzvf apache-maven-3.9.0-bin.tar.gz -C /usr/local/

# Ghi biến môi trường
echo 'export JAVA_HOME=$(/usr/libexec/java_home -v 11)' >> ~/.zshrc
echo 'export MAVEN_HOME=/usr/local/apache-maven-3.9.0' >> ~/.zshrc
echo 'export PATH=$JAVA_HOME/bin:$MAVEN_HOME/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

Danh sách kiểm tra môi trường

Hoàn thành tất cả các bước, hãy thực hiện lệnh sau để xác nhận:

1. java -version  → Hiển thị thông tin phiên bản JDK11
2. mvn -v        → Hiển thị phiên bản Maven và đường dẫn Java
3. git --version → Hiển thị phiên bản 2.33+
4. Khởi động IDEA, tạo dự án Spring Boot mới → Có thể tải dependency bình thường