PyCharm 2025.2 Help

故障排查

JetBrains IDEs 的 远程开发 功能仍处于积极开发阶段，因此可能会出现一些问题。 此页面旨在帮助您在设置或以后的工作中进行初步故障排除。

设置

问题

回答

JetBrains Gateway 有什么不同吗？从 Toolbox 下载的，与单独下载的，还是从 IDE 下载的？

独立的 JetBrains Gateway 支持“在 IDE 中打开”您的 基于 Space 的项目 。如果您不使用它，安装程序和工作流程没有其他区别。

检查 安装场景。

我可以将远程开发指向我远程服务器上的现有 IDE 吗？ 是否可以手动安装 IDE？

自从版本 221.5481 以来，您可以手动注册远程服务器上的现有后端 IDE，并使其对 JetBrains Gateway 可见。 已安装的 IDE 将出现在可用构建的列表中：

  1. 通过 SSH 进入远程服务器。

  2. 找到解压后的 IDE 文件夹，进入 bin 文件夹。

  3. 在命令行中，执行以下命令：

    remote-dev-server.sh registerBackendLocationForGateway

    例如，

    sh PyCharm-221.5591.52/bin/remote-dev-server.sh registerBackendLocationForGateway

JetBrains Gateway 安装本身未能成功完成

  • 请确保您的系统用户有权限安装软件，或者联系您组织中的系统管理员。

为什么在设置过程中 SSH 连接到远程服务器失败？

  • 远程服务器端或虚拟机提供商禁止传入连接。 在 AWS 的情况下，请不要忘记调整“Security groups”

  • 在远程端，您的 SSH 监听非标准端口

  • 密码或密钥文件不正确或由于多次失败导致连接被阻止

JetBrains Gateway 在 检索 IDE 版本 步骤挂起，无法加载可用的 IDE

JetBrains Gateway 尝试连接但失败。 凭证 100% 正确。

  • 请确保 AllowТcpForwarding 在 sshd_config 上的远程服务器上已启用，因为它是将远程 IDE 进程的流量重定向到您的本地机器所必需的。

我从本地计算机选择了一个 IDE 安装程序，但上传过程失败了

  • 远程服务器的磁盘可用空间不足。 您的远程服务器上的可用空间必须至少为 4xIDE.tar.gz。

    自 2022.1.1 版起，您可以在远程服务器上选择自定义路径作为部署目标位置。

  • 您上传的不是 .tar.gz 安装程序存档，因此无法在远程端解压。

  • 您上传了 Community 版本的归档。 远程开发适用于付费版本。

远程开发工作器上传失败，错误“退出代码：139 (SIGSEGV)”

如果您的远程机器操作系统是 RHEL、CentOS、RockyLinux，请检查 SELinux 警告的 syslog 或禁用 SELinux 并重试安装

在本地机器上，进程会出现“Failed to download JetBrains Client”错误

您的本地计算机必须与以下 JetBrains URL 建立网络连接：

  • https://code-with-me.jetbrains.com

  • https://download.jetbrains.com

  • https://download-cf.jetbrains.com

  • https://download-cdn.jetbrains.com

  • https://cache-redirector.jetbrains.com

或者，您可以配置 完全离线模式。

与远程项目协作

问题

回答

60 秒内无法获取 IDE 状态。 可能是 IDE 后端卡住了

  • 后端服务器的 shell 是交互式的，或有配置错误，因此部署命令未能正确完成。

    请尝试用默认 config 或简单的 bash 替换它

  • 后台 IDE 由于资源不足而挂起并且没有响应:

    1。 通过 ssh 进入远程服务器并手动终止 IDE 进程。

    2。 通过编辑 JVM 选项文件向远程 IDE 添加内存。 默认部署设置可能不适合普通或大型项目。

    3。 查找远程 IDE JVM 设置文件：

    $IDE_BIN_DIR/${IDE_PRODUCT_VM_OPTIONS}.vmoptions

    请查看以下示例：

    ./.cache/JetBrains/RemoteDev/dist/a17ad99f7faf8_ideaIU-2021.3.1/bin/idea64.vmoptions

    4。 编辑 -Xmx 值并使用新设置重复部署/连接

  • 后端 IDE 无法处理您的项目（资源不足、配置错误、依赖项损坏）。

    通过 ssh 进入远程服务器并按照 此页面的描述手动启动项目并检查输出。

    如果项目成功启动，复制生成的链接并尝试从本地 Gateway 连接（文章中也有描述）。

CPU 或资源使用情况异常

  • 为了诊断性能问题，支持团队需要日志 （帮助 -> 收集主机和客户端日志） 、服务器的 CPU 快照 （帮助 -> 诊断工具 -> 开始 CPU 使用率分析） ，以及堆转储（如 java_error_in_idea*.hprof 的文件）。

    如需了解有关诊断性能问题的更多信息，请参阅 报告性能问题

IDE 卡住且无响应

  • 当 IDE 停滞且没有响应，导致您无法使用菜单来捕获快照时，请向我们提供 线程转储

远程 IDE 工作正常但停止响应

  • 进入远程服务器并终止 IDE 进程或重启服务器，然后重新测试。

收集日志和提交报告

如果以上解决方案无效，且您需要我们的协助，请提供详细描述。 除了 IDE 版本、日志和线程转储（这是必须的）外，我们还希望提供代码/项目示例、屏幕截图或展示问题的 screencast/gif。

在提交报告时将它们附加到 您的问题。

若要仅使 JetBrains 团队可见该问题，您可以将其可见性设置为 jetbrains-team 组。 除图片外，所有附件默认仅对 JetBrains 团队可见。

从 UI 收集日志

  1. 来自 JetBrains Gateway ：“欢迎（开始）”屏幕 - 左下角 - 齿轮图标 - “收集日志和诊断数据”。

  2. 从您用作远程开发起点的主 IDE： 顶部菜单 - “帮助” - “收集日志和诊断数据”。

  3. 从启动的 JetBrains Client 会话 （连接到您的远程服务器）：顶部菜单 - “帮助” - “收集主机和客户端日志”

手动收集日志

  1. 在本地工作站端 ：位置取决于您本地计算机的操作系统。

    我们建议收集并发送 IDE 使用的目录 中的整个日志文件夹。

  2. 在远程服务器上 ：日志分别位于每个 IDE 的安装文件夹中。

    默认安装路径是 ~/.cache/JetBrains/<product><versions>/log/

    例如， ~/.cache/JetBrains/IntelliJIdea2024.1/log/

最后修改日期： 2025年 9月 26日
关于远程开发的常见问题许可和有用链接