解决IntelliJ IDEA 项目名称后带中括号问题（模块名不一致）

前言

在 IntelliJ IDEA 中，开发者常会遇到项目名称后带有中括号（如 项目名[模块名]）的现象。这种现象通常由 项目名称（Project Name） 与 模块名称（Module Name） 不一致导致。

问题描述

当项目名称与模块名称不一致时，IDEA 会在项目名称后显示模块名称（以中括号分隔）。例如：

原始状态 ：MyProject[MyModule]
目标状态 ：MyProject

此问题常见于以下场景：

创建项目时 ：项目名称（文件夹名）与模块名称（.iml 文件名）不一致。
Maven/Gradle 项目 ：pom.xml 中的 <artifactId> 与项目名称不一致。
多模块项目：模块名称与实际目录结构不匹配。

问题原因分析

1. 项目名称与模块名称不一致

项目名称 ：通过 File → Project Structure → Project → Project Name 设置。
模块名称 ：通过 File → Project Structure → Modules → Module Name 设置。
中括号逻辑：当两者不一致时，IDEA 会自动在项目名称后追加模块名称以区分。

2. Maven/Gradle 配置冲突

Maven 项目 ：pom.xml 中的 <artifactId> 若与项目名称不一致，可能导致模块名称与预期不符。
Gradle 项目 ：build.gradle 中的 name 属性需与模块名称一致。

3. 缓存与索引问题

缓存残留 ：.idea 文件夹中的 workspace.xml 或模块配置文件未及时更新。
索引异常：IDEA 的项目索引未正确重建，导致显示异常。

解决方案

Step 1：统一项目名称与模块名称

1. 修改项目名称

打开 Project Structure ：
- 菜单路径：File → Project Structure（快捷键 Ctrl+Shift+Alt+S）。
修改项目名称：
- 左侧选择 Project。
- 右侧输入框中修改 Project Name 为期望名称（如 rtrs）。
保存设置：点击 Apply → OK。

2. 修改模块名称

进入 Modules 配置：
- 在 Project Structure 界面，左侧选择 Modules。
修改模块名称：
- 选中目标模块（通常只有一个）。
- 修改 Name 字段为与项目名称一致（如 rtrs）。
检查 .iml 文件：
- 确认 .iml 文件名已自动更新为 rtrs.iml（若未更新，可手动重命名）。

3. 统一文件夹名称

右键项目根目录 → Refactor → Rename ，将文件夹名称修改为与项目名称一致。

Step 2：修正 Maven/Gradle 配置

Maven 项目

打开 pom.xml 文件。

修改 <artifactId> 标签值为与项目名称一致：

xml 复制代码

<project>
    ...
    <artifactId>rtrs</artifactId>
    ...
</project>

保存文件并刷新 Maven 项目（右键项目 → Maven → Reload Project）。

Gradle 项目

打开 build.gradle 文件。
修改 name 属性为与项目名称一致：
groovy 复制代码
```
name 'rtrs'
```
同步 Gradle 配置（顶部菜单栏点击 File → Sync Project with Gradle Files）。

Step 3：清除缓存与重建索引

1. 清除项目缓存

关闭 IDEA。
删除以下文件/文件夹：
- Windows ：
  - .idea 文件夹
  - .iml 文件
- macOS/Linux ：
  - ~/.cache/JetBrains/IntelliJIdea<版本号>/caches/
重新打开项目：IDEA 会自动重建缓存和索引。

2. 手动清除缓存（高级）

菜单路径：File → Invalidate Caches / Restart...。
选择 Invalidate and Restart，强制清除所有缓存并重启 IDEA。

Step 4：验证与调试

1. 检查项目视图

切换到 Project 模式（项目视图右上角下拉菜单）。
确认项目根目录显示正常，无中括号残留。

2. 多模块项目处理

若为多模块项目，确保每个模块的 Name 与文件夹名称一致。
在 Project Structure → Modules 中逐一检查并修正。

注意事项

命名规范 ：建议项目名称、模块名称、文件夹名称、<artifactId> 四者保持一致，避免混淆。
缓存管理 ：定期清理缓存（File → Invalidate Caches），尤其是项目结构频繁变更时。
版本兼容性：升级 IDEA 或构建工具（如 Maven/Gradle）后，需检查配置兼容性。
团队协作：在共享项目时，确保团队成员使用一致的命名规则和配置。

附录：常见问题解答

Q1：修改名称后仍显示中括号？

原因：缓存未清除或配置未生效。
解决：删除 .idea 文件夹并重新加载项目。

Q2：多模块项目如何统一名称？

操作：在 Project Structure → Modules 中逐一修改每个模块的 Name，并同步文件夹名称。

Q3：Maven 项目的 `<groupId>` 和 `<artifactId>` 如何命名？

建议：
- <groupId>：采用公司域名倒序（如 com.example）。
- <artifactId>：与项目名称一致（如 rtrs）。