PyCharm 2026.3 Help

教程:在 PyCharm 中进行部署

将项目文件复制到本地或已挂载的文件夹,比较副本,并配置在保存更改时自动上传。 此设置会传输文件,但不会构建或启动应用程序。

启用 FTP/SFTP/WebDAV Connectivity 插件

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

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

  2. 找到 FTP/SFTP/WebDAV Connectivity 插件,然后点击 启用。

在开始之前

请确保:

  • 您使用的是 PyCharm 版本 5.0 或更高版本。 本教程基于 PyCharm 2024.1 编写。

  • 您拥有要将代码部署到的远程主机的访问权限。

配置部署服务器

添加新服务器

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 构建、执行、部署 | 部署。

    或者,转到主菜单中的 工具 | 部署 | 配置。

  2. 点击 添加条目 ,然后选择 本地或已挂载的文件夹。

    添加服务器对话框
  3. 在打开的 创建新服务器 对话框中,输入服务器名称并点击 确定。

    已添加新服务器,但它仅显示 Web 服务器 URL http://localhost ,您将通过该地址实际浏览已上传的文件。

指定服务器根文件夹

  1. 在 文件夹 字段中,指定要上传项目文件的目录。

    输入所创建目标文件夹的绝对路径,或点击 浏览 选择它。

    在本例中,这是 /Users/jetbrains/deployment 本地文件夹。 您可以手动输入路径或按 Shift+Enter。

  2. 保持 仅对该项目可见 处于选中状态,以在当前项目中使用此配置。 如果想在其他项目中使用该配置或稍后导出它,请清除此项。

    部署连接选项卡

指定部署路径

  1. 接下来,切换到 映射选项卡。

    不过,您可以在项目树中选择任何其他目录。 我们就使用默认路径。

  2. 在 部署路径 字段(默认为空)中,指定服务器上的文件夹,PyCharm 会将 本地路径 字段中指定的文件夹中的数据上传至该文件夹。

    在本例中,为 应用 。 此路径是相对于 Web 服务器根文件夹指定的,即 Users/jetbrains/deployment 。

  3. 对 Web 路径 保持默认的 / 值。

    部署映射选项卡

应用更改后,服务器即可使用。

浏览远程主机

请选择 工具 | 部署 | 浏览远程主机。 在 远程主机 工具窗口中,选择 MyRemoteServer 以浏览目标文件夹。

远程主机工具窗口

部署文件

将文件上传到服务器

  1. 在 项目 工具窗口 Alt+1 中,右键点击 README.md 。

  2. 请选择 部署 | 上传到 MyRemoteServer。 如果未显示此操作,请选择 部署 | 上传到…… ,然后选择 MyRemoteServer。 在 文件传输 工具窗口中检查结果。

    部署上传

您也可以上传项目中各目录的内容。 在 项目 工具窗口中右键点击要上传的目录,然后选择 部署 | 上传到 MyRemoteServer。

比较远程与本地版本

本地和远程均有一份 README.md 文件的副本,且二者完全相同。 修改本地版本。

  • 在 “远程主机”工具窗口 工具窗口中,右键点击 README.md ,然后选择 与本地版本比较。 PyCharm 会打开差异查看器。

    差异查看器

从服务器下载文件

  1. 在 “远程主机”工具窗口 工具窗口中,右键点击 README.md 文件,然后选择 从此处下载。 PyCharm 会显示一条警告。

    部署下载警告

同步更改

将文件自动上传到默认服务器

当您需要使服务器上的文件与 一个 PyCharm 项目中的文件完全一致时,自动上传会很有帮助。 自动上传意味着,只要在 IDE 中发生更改,就会将其部署到默认部署服务器。

如果在自动上传已更改文件时默认应用其设置,则该部署服务器被视为默认服务器。

定义默认服务器

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 构建、执行、部署 | 部署。

    或者,转到主菜单中的 工具 | 部署 | 配置。

  2. 在服务器列表中,选择要设为默认的服务器,然后点击服务器列表上方工具栏中的 用作默认按钮。

启用自动上传

设置默认服务器后,您即可将上传到该服务器的操作设为自动执行。

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 构建、执行、部署 | 部署 | 选项。

    或者,转到主菜单中的 工具 | 部署 | 选项。

  2. 在 将更改的文件自动上传到默认服务器 下拉列表中,选择以下选项之一:

    • 始终 :在每次自动保存和手动保存时上传文件。

    • 在显式保存操作时 :仅当通过选择 文件 | 全部保存 或按下 Ctrl+S 手动执行保存时,才在保存后上传文件。

不建议在部署到生产环境时使用 始终 模式:在开发期间,未完成的代码可能会被上传,从而可能破坏生产应用。

上传外部更改

外部更改是在 IDE 外部进行的更改,例如 Git 分支更改或由代码生成器更新的文件。 这些更改可能来自在 PyCharm 内部或外部运行的工具。

要将这些更改包含在自动上传中,请打开 设置 | 构建、执行、部署 | 部署 | 选项。 将 将更改的文件自动上传到默认服务器 设置为 始终 或 在显式保存操作时 ,并清除 跳过外部更改。

使用 在显式保存操作时 时,请使用 文件 | 全部保存 Ctrl+S 上传待处理的更改。

使用 从不 时,自动上传会被禁用,并且 跳过外部更改 不可用。

跳过外部更改

导出/导入部署设置

现在您已完成部署服务器的全部设置,您可以导出服务器部署设置,然后在另一台计算机上导入。

将设置导出到 ZIP 归档

  1. 在主菜单中选择 文件 | 管理 IDE 设置 | 导出设置。

  2. 在打开的 导出设置 对话框中,确保已选中 WebServers 复选框,并指定目标归档的路径。

    导出服务器部署设置

从 ZIP 归档导入设置

  1. 在主菜单中选择 文件 | 管理 IDE 设置 | 导入设置…。

  2. 在打开的对话框中,选择包含您设置的 ZIP 存档。

  3. 在打开的 选择要导入的组件 对话框中,选择您要应用的设置,然后点击 确定。

总结

已配置本地或已挂载的目标,复制并比较了文件,并启用了自动上传。 要通过 SFTP 将文件传输到另一台计算机,请创建一个 远程服务器配置。

2026年 11月 3日