修改流程#

首先你需要在文件->项目结构->项目条目下，修改右侧的名称和编译器输出为新的名字。

若需要修改模块名称，则需要在文件->项目结构的项目设置->模块条目下，修改相应的信息。

之后你需要修改项目文件夹根目录的名字，可在主界面左侧的项目界面，右键最上方的模块，选择打开于->资源管理器来快捷跳转。

修改成功后可 重启IDEA 或 文件->关闭项目，右键原来的项目，选择从最近的项目中移除...或直接点击右侧的×号。

WARNING

现在仍然不能直接在IDEA中打开修改后的项目文件夹，因为项目目前无法建立正确的索引。直观地来看，表现为左侧只出现.iml和.gitignore，同时无法识别其他的文件（夹）。

然后在资源管理器中打开项目名称/.idea，修改modules.xml。

1
<?xml version="1.0" encoding="UTF-8"?>
2
<project version="4">
3
  <component name="ProjectModuleManager">
4
    <modules>
5
      <module fileurl="file://$PROJECT_DIR$/YourProjectOldName.iml" filepath="$PROJECT_DIR$/YourProjectOldName.iml" />
6
      <module fileurl="file://$PROJECT_DIR$/YourProjectNewName.iml" filepath="$PROJECT_DIR$/YourProjectNewName.iml" />
7
    </modules>
8
  </component>
9
</project>

最后需要修改相应的构建配置。

1. 对于maven构建的项目，需要修改pom.xml中的<artifactId>和<name>（后者决定了IDEA的Maven面板和生成文档时显示的名字）。
2. 对于gradle构建的项目，需要修改settings.gradle或settings.gradle.kts中的rootProject.name。
3. 对于其他方式构建的项目，需要修改相应的配置文件参数和文件->项目结构->工件的相关信息。

至此，项目的重命名就基本完成了。项目此刻应该可以正常被运行和构建。

如果你 未经IDEA的重命名功能，手动重命名了包名，则需继续参考以下文章来进行修改。

IDEA手动修改包名的相应措施

常见错误#

当你看到IDEA提示Git Repositories Found: The directory [旧路径] is registered as a Git root, but no Git repository was found there.时，这表明你需要更新IDEA中的Git映射。

具体地，你需要在文件->设置->版本控制->目录映射中点击-删除旧路径，并点击+添加新路径。建议启用下方的启用自动映射检测，这会节省一些功夫。