PyCharm 2025.1 Help

使用 SSH 配置解释器

通过 SSH 配置远程 Python 解释器

  1. 请确保远程主机上运行着一个 SSH 服务器,因为 PyCharm 通过 ssh-session 运行远程解释器。

  2. 请执行以下操作之一:

    • 点击 Python Interpreter 选择器 并选择 添加新的解释器

    • Ctrl+Alt+S 以打开 设置 并转到 项目:<项目名称> | Python 解释器。 点击可用解释器列表旁的 添加解释器 链接。

    • 点击 Python Interpreter 选择器 并选择 解释器设置。 点击可用解释器列表旁的 添加解释器 链接。

  3. 请选择 通过 SSH

  4. 选择一个选项以创建新的 SSH 连接,然后指定服务器信息(主机、端口和用户名)。

    通过 SSH 添加解释器

    或者,您可以选择 现有 并从列表中选择任何可用的 SSH 配置。 要创建新的 SSH 配置,请按照以下步骤操作:

    创建 SSH 配置
    • 点击配置列表旁的 浏览按钮

      添加新的 SSH 配置
    • 点击 新配置 ,禁用 仅对此项目可见 复选框,并填写所需字段:

      添加新的 SSH 配置
    • 完成后,新创建的 SSH 配置将出现在可用配置列表中。 它还将在 SSH 部署配置设置中可用。 点击 下一个 继续:

      正在连接到 SSH 服务器
  5. 在下一个对话框窗口中,提供连接目标服务器的身份验证详细信息。

    指定身份验证详细信息

    选择 密码密钥对(OpenSSH 或 PuTTY) 并输入您的密码或密码短语。 如果 密钥对(OpenSSH 或 PuTTY) 被选中,请指定:

    • 私钥 :私钥文件的位置

    • 密码短语 :类似于密码,它用于 加密私钥

    点击 下一个 继续。

  6. 等待 PyCharm 完成对 SSH 服务器的自省。

    SSH 服务器自省
  7. 在下一个对话框中,选择要在 SSH 服务器上配置的 Python 环境类型。

    选择 Python 环境

    您可以创建一个新的 虚拟环境conda 环境,选择一个现有环境,或使用系统解释器。

    • 如果您希望将机器上全局 Python 中安装的所有包都添加到您将要创建的虚拟环境中,请选择 继承全局 site-packages 复选框。 此复选框对应 --system-site-packages 选项的 virtualenv 工具。

    • 如果您需要以 sudo 用户身份在 SSH 服务器上执行 Python 代码,请启用 通过 sudo 以 root 权限执行代码 复选框。

    • 您可以配置本地项目与服务器之间的路径映射。 为此,请点击 浏览 图标,位于 同步文件夹 字段中,并输入本地项目文件夹的路径以及远程服务器上文件夹的路径。

    点击 创建 完成添加解释器。

切换 SSH 解释器时同步项目文件

当您更改项目解释器并选择 SSH 解释器时,可能需要将本地内容与目标服务器同步。 注意右下角的通知气泡:

将本地文件与部署服务器同步

您可以选择启用文件自动上传到服务器:

  • 点击 自动上传文件 以在下次保存时开始上传。

  • 点击 同步并自动上传文件 以立即同步文件并在将来每次保存时上传。

要配置其他设置,请从主菜单中选择 工具 | 部署 | 选项

最后修改日期: 2025年 4月 23日