IDEA 项目 SVN 配置消失、版本控制变成 Git 且无 VCS 菜单的解决办法

有一个 Java 项目长期使用 SVN 管理。很久没有打开后，今天用 IDEA 重新打开，发现项目里的版本控制变成了 Git，但项目本身并没有 Git 地址；同时在 IDEA 中也找不到 SVN 相关配置入口。

比较关键的一点是：另一个常用项目在同一个 IDEA 中打开时，SVN 界面和设置都正常（两个独立窗口），说明 IDEA 的 Subversion 插件本身没有问题，问题只出在这个很久没打开的项目上。

另外检查过项目文件夹，里面并没有 .git 目录；IDEA 顶部菜单栏也没有出现 VCS 菜单。这种情况下，通常不是插件缺失，而是该项目自身的 VCS 目录映射丢失或被错误识别，需要手动把项目目录重新映射到 Subversion。

IDEA 的版本控制菜单和 SVN 操作入口，依赖于项目级的 VCS 目录映射配置。如果项目很久没有打开，或者 .idea 下的项目配置发生变化，就可能出现：

此时可以通过 Settings -> Version Control -> Directory Mappings 手动添加 Subversion 映射来解决。

在 IDEA 顶部菜单栏进入：

File -> Settings

macOS 下如果是 IntelliJ IDEA -> Preferences，进入设置即可。

在设置窗口左侧找到：

Version Control -> Directory Mappings

右侧会显示当前项目的目录与版本控制映射列表。

如果这里存在错误的 Git 映射，可以先删除或后续改为 Subversion；如果列表为空，则直接新增映射。

在 Directory Mappings 页面左上角点击 + 号，弹出新增映射窗口。

在弹出的映射窗口中：

这里有一个前提：项目必须已经从 SVN 检出，也就是项目根目录下存在 .svn 文件夹 。只有根目录存在 .svn 时，才可以放心把项目根目录映射为 Subversion。

如果项目根目录下没有 .svn，而 .svn 存在于某个子目录中，则不要直接选项目根目录，而应选择实际包含 .svn 的那个 Directory。

选择完成后，点击 Save Mapping 保存映射，然后点击设置窗口下方的 Apply。

点击 Apply 后，通常可以看到：

设置前：

设置后：

确认 .svn 是否存在

.svn 是隐藏文件夹，需要开启显示隐藏文件后检查。
- 如果 .svn 在项目根目录：可以将项目根目录映射为 Subversion；
- 如果 .svn 在子目录：应映射实际包含 .svn 的子目录；
- 如果完全没有 .svn：说明该项目当前不是 SVN 工作副本，需要先从 SVN 重新检出。
不要被"变成 Git"误导

项目中如果没有 .git，但 IDEA 显示 Git，通常是项目级 VCS 映射配置错误。重新添加 Subversion 映射即可纠正。
插件正常不代表项目映射正常

另一个项目 SVN 界面正常，说明 IDEA 的 Subversion 插件没有问题。当前项目缺少的是自己的目录映射配置。

这个问题的核心不是 IDEA 的 SVN 插件损坏，而是当前项目的 VCS 目录映射丢失或被错误识别。解决方式就是：

Settings -> Version Control -> Directory Mappings -> + -> Version control 选择 Subversion -> 选择项目根目录或包含 .svn 的目录 -> Save Mapping -> Apply

操作完成后，IDEA 顶部 VCS 菜单和项目中的 SVN 相关功能就会重新显示出来。