PyCharm 2026.3 Help

从 PyCharm 连接到远程服务器

随着远程办公成为刚需,PyCharm 提供远程开发功能,以帮助您在远程环境中编写代码、运行、调试并部署项目。

通过 SSH 连接

与远程服务器的连接通过 SSH 完成,并且可以直接在 PyCharm 的欢迎屏幕中开始。

连接到远程服务器并打开远程项目

  1. 请确保已启用捆绑的 JetBrains OS 集成 插件。

  2. 在欢迎屏幕的左侧窗格中,选择 远程开发。 或者,在主菜单中转到 文件 | 远程开发。

  3. 在 连接到远程 对话框中,点击 SSH。

    如果 IDE 已在远程服务器上运行,并且已有 连接链接 ,可以点击 链接 ,并将实际链接添加到 连接到正在运行的 IDE 部分下的字段中。

  4. 如果没有任何最近的配置,请从下拉菜单中选择 SSH 配置 以打开 SSH 配置 设置。

    PyCharm 欢迎屏幕
  5. 配置远程服务器连接参数,点击 测试连接 以确保与远程服务器的连接成功,然后点击 确定 以保存更改。

  6. 返回 连接到远程 对话框后,添加 SSH 连接并点击 连接。

  7. 指定项目目录并点击 打开项目 或 跳过并打开 IDE。

有关如何开始使用单独的 JetBrains Gateway 安装程序的信息,请参阅 JetBrains Gateway。

有关添加插件或 SDK 的详细信息,请参阅相应的 入门部分。

连接到在 WSL2 上运行的项目

您可以将 IDE 后端配置为直接在 WSL2 中启动。

在开始连接到 WSL 之前,请检查 现有先决条件 ,并确保满足以下附加条件:

  • 您的计算机已安装 Windows 10 或 11,并在 WSL2 下安装了 Ubuntu 20.04。

  • 您的 Windows 计算机上已配置 WSL2。 有关更多信息,请参阅 WSL2 配置部分。

连接到 WSL

  1. 请确保已启用 Remote Development Gateway 插件。

  2. 在欢迎屏幕的左侧窗格中,选择 远程开发。

  3. 在 远程开发 下,选择 WSL。

  4. 单击 新建连接。

  5. 在下一页,选择 WSL 实例并点击 下一条。

  6. 在下一页,选择 IDE 版本和您要打开的项目。 单击 启动 IDE 并连接。

    连接已建立,已下载 IDE 后端,并在 JetBrains Client 中打开项目。

JetBrains Gateway 用作通过 SSH 连接到远程服务器的入口。 它会启动 JetBrains Client ,这是一款瘦客户端,使您能够处理远程项目。

您可以使用以下任一方式启动 JetBrains Gateway:

2026年 11月 3日