JetBrains Rider 2026.1 Help

不同类的信息 在 Windows 上进行调试器连接故障排除

在某些情况下,Rider 调试器无法附加到 Unity 编辑器,并显示一条错误信息:

JetBrains Rider:无法连接到 Unity 编辑器

Unity 编辑器在启动时会打开一个特定端口,供外部调试器附加。 该端口的定义如下: 56000 + (UnityEditor Process Id % 1000)。 这意味着需要如下端口范围可用: 56000-56999。 如果系统中有内容阻止了该范围的部分端口,将无法连接任何调试器。

检查 Windows NAT 服务

有时这是由于 Windows NAT 服务导致,它会占用 Unity 范围内的部分端口。 要检查此问题,请在终端中运行以下命令:

netsh int ip show excludedportrange protocol=tcp

如果看到有范围与 56000-56999 有交集,请使用管理员终端重启该服务:

net stop winnat net start winnat

关闭 Unity Hub 和 Unity 编辑器后重新打开。 现在 Rider 应该可以连接调试器了。

故障排除其他进程

如果仍无效,说明有其他进程占用了 Unity 需用的端口。 可以通过以下方式进行故障排除:

  1. 打开任务管理器,找到 Unity 编辑器进程并记下其 PID:

    任务管理器中的 Unity 编辑器进程
  2. 计算端口号,取最后三个数字并加在 56 后面。 例如,如果 PID 是 207048 ,则端口为 56048

  3. 通过运行以下命令检查哪些进程正在使用此端口:

    netstat -ano | findstr :[PORT]
    JetBrains Rider:Unity 调试器故障排除。 netstat 输出
  4. 在任务管理器中找到右侧显示该 PID 的进程,并结束或重新配置它。

2026年 5月 8日