PyCharm出现Invalid VCS root mapping报错如何解决

触发报错时的提示信息：

The directory \OIDv4_ToolKit is registered as a Git root, but no Git repositories were found there.

报错原因：PyCharm的版本控制映射配置中，将\OIDv4_ToolKit路径标记为Git仓库根目录，但扫描该路径时未找到Git仓库必需的.git元数据目录，因此抛出映射无效的错误。根据实际使用需求，按对应场景处理即可：

场景1：该目录不需要关联Git版本控制 #

这是最常见的触发场景，多为之前误添加映射、删除本地仓库后配置未同步清理导致，直接删除无效映射即可：

• 打开PyCharm设置面板：Windows/Linux系统使用快捷键Ctrl+Alt+S，Mac系统使用快捷键Cmd+,
• 在设置菜单中找到Version Control（版本控制）配置项
• 在右侧展示的目录映射列表中，找到路径指向\OIDv4_ToolKit的映射条目
• 选中该条目后点击列表上方的-（减号）按钮删除，最后点击面板右下角的Apply→OK保存配置，报错会即时消除。

场景2：该目录需要关联Git版本控制 #

这类情况是路径本身应当作为Git仓库使用，要么未完成仓库初始化，要么映射路径配置错误，对应处理方式：

• 未初始化Git仓库：打开系统终端，切换到\OIDv4_ToolKit目录下，执行git init命令完成仓库初始化，回到PyCharm后等待VCS自动扫描识别即可；如果是之前克隆仓库不完整导致.git文件夹缺失，重新完整克隆对应仓库到目标路径即可
• 映射路径配置错误：回到Version Control配置页，选中\OIDv4_ToolKit对应的映射条目，点击编辑按钮，将路径修改为实际存放Git仓库（包含.git文件夹）的正确目录，保存配置后即可恢复正常。

内容的提问来源于stack exchange，提问作者Ki Ki