PyCharm 2025.2 Help

使用 SSH 配置解释器

启用 FTP/SFTP/WebDAV 连接插件

此功能依赖于 FTP/SFTP/WebDAV Connectivity插件,该插件默认在 PyCharm 中捆绑并启用。 如果相关功能不可用,请确保您未禁用该插件。

  1. 按下 Ctrl+Alt+S 打开设置,然后选择 插件

  2. 打开 已安装 选项卡,找到 FTP/SFTP/WebDAV Connectivity插件,并选中插件名称旁边的复选框。

通过 SSH 配置远程 Python 解释器

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

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

  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 中安装的所有包都添加到您将要创建的虚拟环境中,请选择 从基本解释器继承包 复选框。 此复选框对应 --system-site-packages 选项的 virtualenv 工具。

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

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

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

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

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

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

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

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

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

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

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

最后修改日期: 2025年 9月 26日