PyCharm 2025.3 Help

疑难解答

面向 JetBrains IDE 的 远程开发 功能仍处于积极开发阶段，因此可能会出现一些问题。 本页旨在帮助您在设置期间或后续使用过程中进行初步的疑难解答。

设置

问题

回答

来自 Toolbox 的 JetBrains Gateway、单独下载的 JetBrains Gateway，或来自 IDE 的 JetBrains Gateway 之间有区别吗？

独立版 JetBrains Gateway 支持将您的 基于 Space 的项目 以 "Open in IDE" 的方式打开。若您不使用该功能，则安装程序和工作流程没有其他区别。

请查看 安装方案。

是否可以将 Remote Development 指向远程服务器上现有的 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，请勿忘记调整 "安全组"。

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

  • 密码或密钥文件不正确，或者由于多次失败，您的连接已被阻止。

JetBrains Gateway 卡在 获取 IDE 版本 步骤，且未加载可用的 IDE。

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

  • 请确保已在远程服务器的 sshd_config 中启用 AllowТcpForwarding ，因为将远程 IDE 进程的流量重定向到您的本地计算机需要该设置。

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

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

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

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

  • 您上传了社区版的归档文件。 远程开发仅适用于付费版本。

上传 remote-dev-worker 失败，出现 "exit code: 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 为交互式，或存在配置错误，因此部署命令无法正确完成。

    请尝试将其替换为默认配置或简单的 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 版本、日志和线程转储之外，我们也欢迎能说明问题的代码／项目示例、屏幕截图或屏幕录制／ 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年 12月 2日
关于远程开发的常见问题授权及实用链接