Rider IDE连接Perforce服务器异常：测试成功仍显示无连接的解决方法

问题场景 #

搭建本地Perforce服务器存储Unreal Engine项目，使用Rider作为代码编辑器时遇到以下问题：

• Rider左上角始终显示“No Perforce Connections”（对应截图：Rider界面左上角无Perforce连接标识）
• 手动配置Rider的Perforce参数后测试连接成功，但修改文件时无法选择要应用的changelist（对应截图：文件修改后无changelist选项）
• 通过环境变量配置Perforce时，测试连接直接失败

解决方案 #

• 确认Perforce集成已启用
  进入Rider的Settings > Version Control > Perforce，确保Enable Perforce integration选项处于勾选状态。很多时候测试连接成功但未启用集成，会导致界面不加载连接信息。

• 验证工作区与项目路径映射
  打开Perforce客户端（如P4V），检查Unreal项目文件夹是否正确映射到Perforce工作区的对应路径。也可以在Rider终端执行p4 info命令，查看输出的Workspace name和Root是否与项目所在工作区一致。

• 重置Rider的Perforce缓存
  关闭Rider，找到对应缓存目录：

  • Windows：C:\Users\<你的用户名>\AppData\Local\JetBrains\Rider<版本号>\caches
  • Mac：~/Library/Caches/JetBrains/Rider<版本号>
    删除其中与Perforce相关的缓存文件（如perforce开头的文件夹），重启Rider后重新配置连接。

• 排查环境变量配置错误
  若使用环境变量配置，需确保三个核心变量值正确：

  • P4PORT：格式为localhost:1666（对应本地Perforce服务器端口）
  • P4USER：你的Perforce用户名
  • P4CLIENT：关联项目的Perforce工作区名称
    配置完成后重启Rider，或在终端执行p4 set查看变量是否生效，再重新测试连接。

• 同步Unreal Engine的版本控制设置
  打开Unreal编辑器，进入Edit > Project Settings > Source Control，确认已选择Perforce作为版本控制，且配置参数（服务器地址、用户名、工作区）与Rider完全一致。Unreal的设置会影响Rider对项目版本控制的识别。

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