步骤 1：使用 Spring Initializr 创建父项目
- 打开IntelliJ IDEA，选择 File > New > Project。
- 选择 Spring Initializr 并配置项目信息：
- Group ID：例如
com.aqian，用于项目的组织标识。 - Artifact ID：例如
cangqiong（即父项目名称），用于项目的唯一标识。 - Packaging：选择
pom，确保父项目仅作为架构项目，无需生成src文件夹。 - Java version：选择您项目所需的 Java 版本。
- Group ID：例如
- 选择项目依赖：勾选所有子模块需要的公共依赖（例如 Spring Boot Web、Spring Data JPA、Spring Boot DevTools 等）。这样公共依赖会添加到父项目的
pom.xml中，所有子模块均能继承。 - 点击 Finish，完成父项目的创建。
步骤 2：删除父项目中不需要的文件夹
-
删除自动生成的
src文件夹，因为父项目不包含业务代码，仅用作管理。 -
保留以下文件和文件夹：
pom.xml：父项目的核心配置文件，管理依赖和插件。.gitignore：指定需要忽略的文件（如target文件夹）。.idea：IntelliJ IDEA 项目配置文件夹。
-
配置父项目
pom.xml文件：确保packaging设置为pom，并在<dependencyManagement>中添加通用依赖。<packaging>pom</packaging> <dependencyManagement> <dependencies> <!-- 父项目定义的公共依赖，子模块会自动继承 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-jpa</artifactId> </dependency> <!-- 可以添加其他所有子模块需要的依赖 --> </dependencies> </dependencyManagement> <build> <plugins> <!-- Spring Boot 插件，用于运行和打包 Spring Boot 应用 --> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin> </plugins> </build>
步骤 3：为父项目添加子模块
- 右键父项目，选择 New > Module。
- 选择 Spring Initializr 作为模块类型，然后配置子模块信息：
- Group ID：与父项目相同，例如
com.aqian。 - Artifact ID：例如
module1（子模块名称）。 - 不勾选公共依赖（如 Spring Boot Web、Data JPA 等），因为这些依赖已经在父项目中配置。
- Group ID：与父项目相同，例如
- 完成创建后，IDEA会生成一个包含
src文件夹和pom.xml的子模块。
步骤 4：清理子模块不必要的文件
-
只保留
src文件夹和pom.xml文件。 -
配置子模块的
pom.xml：- 在
<parent>中设置子模块继承父项目配置，并删除<relativePath/>标签，避免路径配置错误。 - 删除
<build>配置，使子模块直接使用父项目的构建配置，避免冗余。
示例子模块的
pom.xml：<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <parent> <groupId>com.aqian</groupId> <artifactId>cangqiong</artifactId> <version>0.0.1-SNAPSHOT</version> </parent> <groupId>com.aqian</groupId> <artifactId>module1</artifactId> <version>0.0.1-SNAPSHOT</version> <dependencies> <!-- 子模块特定的依赖（如果有）可以在这里添加 --> </dependencies> </project> - 在
-
重复以上步骤，为其他模块创建并配置
pom.xml，确保所有子模块继承父项目。
步骤 5：在父项目 pom.xml 中添加 <modules>
-
打开父项目的
pom.xml文件，确保每个子模块都在<modules>标签中。如果没有自动添加，可以手动配置，如下所示：<modules> <module>module1</module> <module>module2</module> <!-- 其他子模块名称 --> </modules>
步骤 6：构建和测试项目
-
在Maven工具窗口（通常位于右侧）点击 Reload All Maven Projects，确保所有子模块和依赖加载到位。
-
使用
mvn install命令：在父项目的根目录下运行mvn install命令，这会构建父项目及其所有子模块，并将生成的构建工件（如.jar文件）安装到本地Maven仓库。mvn install作用：mvn install命令会执行项目的完整构建流程，包括以下步骤：通过
mvn install，所有模块的.jar文件将会保存在本地仓库，便于子模块间的相互依赖和项目集成。- 编译：将 Java 源代码编译成字节码（
.class文件）。 - 测试：执行单元测试并生成测试报告。
- 打包：将编译和测试后的代码打包成
.jar文件（或其他格式，取决于pom.xml中的配置）。 - 安装：将打包生成的
.jar文件安装到本地Maven仓库（默认路径为~/.m2/repository），以便其他项目或模块可以引用这些构建工件。
- 编译：将 Java 源代码编译成字节码（
步骤7：配置.gitignore文件
.gitignore文件内部用来规定哪些文件不会被提交到git仓库。
.gitignore 文件用于指定应被 Git 忽略的文件或目录，其语法规则如下：
1.空行：被忽略，可用于分隔不同的规则块。
2.注释：以 # 开头的行被视为注释。
# 这是一个注释
3.通配符：
*（星号）：匹配零个或多个任意字符，但不匹配路径分隔符 /。
*.log # 匹配所有以 .log 结尾的文件
?（问号）：匹配任意单个字符。
config?.yml # 匹配 config1.yml、configA.yml 等
[]（方括号）：匹配方括号内的任意一个字符。
test[12].txt # 匹配 test1.txt 和 test2.txt
**（双星号）：匹配任意层级的目录。
**/logs # 匹配任意位置的 logs 目录
4.目录匹配：
-
以
/结尾：表示匹配目录。temp/ # 匹配 temp 目录 -
以
/开头：表示从仓库根目录开始匹配。/build # 仅匹配仓库根目录下的 build 文件或目录
5.取反匹配：以 ! 开头的模式表示例外，即不忽略匹配该模式的文件或目录。
*.log
!important.log # 忽略所有 .log 文件，但不忽略 important.log
注意：如果父目录已被忽略，则子文件或目录即使使用取反模式也无法被包含。
6.转义字符：如果文件名中包含特殊字符（如 #、! 等），可使用反斜杠 \ 进行转义。
\#important.log # 匹配文件名为 #important.log 的文件
步骤8：为子模块配置SDK
多模块项目的配置缺失：多模块项目中，子模块的语言级别和 SDK 设置可能不会自动继承父项目配置，因此需要手动确认。
Project SDK：指定了项目使用的 JDK 版本，它提供了 Java 编译器、运行时以及核心库（如 java.lang.String 等基础类）。如果没有指定正确的 SDK，IDE 就无法找到这些核心库，从而导致无法解析符号的错误。
如何在 IntelliJ IDEA 中设置
具体操作如下：
1.配置项目级别的 SDK 和语言级别
- 打开
File > Project Structure > Project。 - 在
Project SDK下拉菜单中，选择适合的 JDK 版本。如果列表中没有目标 JDK，可以通过New按钮添加。 - 在
Project language level下拉菜单中，选择匹配的 Java 语言级别。
2.配置模块级别的 SDK 和语言级别
- 进入
File > Project Structure > Modules。 - 选择子模块，在右侧设置
SDK为项目 SDK。 - 在
Language Level下拉菜单中，确保选择了与项目兼容的语言级别。
步骤9：提交到Gitee远程仓库
- 本地分支：在你的本地 Git 仓库中创建和管理的分支。每个本地分支有独立的开发历史和变更记录。
- 远程分支：指的是在远程仓库（如 GitHub、Gitee 等）中的分支。远程分支通常与团队其他成员共享，用于协作开发。
- 推送（Push）：将本地分支的更新推送到远程分支，使团队成员看到你的改动。
- 拉取（Pull）：将远程分支的更改拉到本地分支，确保自己的代码与团队同步。
在 IntelliJ IDEA 中提交到 Gitee 仓库时，不建议直接使用 Gitee 账户的用户名和密码。Gitee 已弃用简单的账户密码方式，推荐使用 访问令牌（Access Token） 来替代密码进行身份验证。
使用 Gitee 的访问令牌（Access Token）
为什么使用访问令牌而非账户密码？
使用访问令牌比直接使用账户密码更安全，而且 Gitee 也不再允许简单密码的远程认证，因此 访问令牌 是推送和拉取代码的推荐方式。
1. 生成 Gitee 访问令牌
- 登录您的 Gitee 账号。
- 点击右上角头像，选择“设置”。
- 在左侧菜单中，选择“安全设置”。
- 找到“私人令牌”部分，点击“生成新令牌”。
- 为令牌命名，选择所需的权限（如
repo、user等），然后点击“生成”。 - 注意：生成的令牌只会显示一次，请妥善保存。
2. 在 IntelliJ IDEA 中配置 Gitee 账户
- 打开 IntelliJ IDEA，点击菜单栏的
File，选择Settings（或Preferences，视操作系统而定）。 - 在设置窗口中，导航到
Version Control>GitHub。 - 点击右侧的“+”按钮，选择“Gitee”。
- 在弹出的对话框中，选择“Log In with Token”。
- 将之前生成的访问令牌粘贴到相应的输入框中，点击“Add Account”。
3. 提交代码到 Gitee 仓库
- 在项目中，右键点击需要提交的文件或目录，选择
Git>Commit。 - 在提交窗口中，填写提交信息，点击“Commit”。
- 提交后，点击“Push”按钮，将代码推送到远程 Gitee 仓库。
最终项目结构
构建完成后，项目结构如下，每个子模块下都会有一个 target 文件夹，用于存放构建结果：
cangqiong/
├── pom.xml # 父项目 POM 文件，包含依赖管理和模块配置
├── .gitignore # Git 忽略文件
├── .idea/ # IDEA 项目配置
├── module1/
│ ├── src/ # 子模块的源代码目录
│ ├── target/ # 子模块的构建结果目录（由mvn install生成）
│ └── pom.xml # 子模块的 POM 文件，继承父项目
└── module2/
├── src/
├── target/
└── pom.xml
注意
- 每个子模块的
target文件夹在运行mvn install或其他构建命令时自动生成，包含.class文件、测试报告、打包的.jar文件等。建议在.gitignore中忽略target文件夹，避免提交到版本控制系统中。
完整的.gitignore 文件配置如下，其中规定了哪些文件不提交到git仓库。
# IntelliJ IDEA 配置
.idea/
*.iml
# Maven 编译输出目录
**/target/
# 忽略操作系统生成的临时文件
.DS_Store
Thumbs.db
