PyCharm 2026.3 Help

使用 SSH 配置解释器

通过 SSH 配置远程 Python 解释器

  1. 请确保远程主机上正在运行 SSH 服务器,因为 PyCharm 通过 ssh-sessions 运行远程解释器。

  2. 请执行下列任一操作:

  3. 如果项目包含子项目,请在左侧列表中选择该子项目。

  4. 点击 解释器 列表旁边的 添加解释器添加解释器… ,然后选择 在 SSH 上……。

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

    通过 SSH 添加解释器

    或者,您可以选择 现有 ,并从列表中选择任一可用的 SSH 配置。 要创建新的 SSH 配置,请执行以下步骤:

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

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

      添加新的 SSH 配置
    • 完成后,新建的 SSH 配置将显示在可用配置列表中。 它也会在 SSH 部署配置 设置中可用。 点击 下一条 以继续:

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

    指定身份验证详细信息

    选择 密码 或 密钥对 (OpenSSH 或 PuTTY) ,并输入您的密码或口令。 如果选择了 密钥对 (OpenSSH 或 PuTTY) ,请指定:

    • 私钥 :私钥文件的位置

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

    点击 下一条 继续。

  7. 请等待 PyCharm 完成对 SSH 服务器的探测。

    SSH 服务器探测
  8. 生成新的或选择已存在的 Python 环境。},{

    可以选择 virtualenv、 conda、 pipenv、 poetry、 uv 或 hatch 环境类型。

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

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

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

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

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

  • 点击 同步并自动上传文件 以立即同步文件,并在后续每次保存时上传它们。

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

或者,转到 设置 | 构建、执行、部署 | 部署 | 选项。

2026年 11月 3日