PyCharm 2025.3 Help

上传和下载文件

PyCharm 提供以下两种方式将项目文件和文件夹上传到 已配置的部署服务器

  • 手动 ,可随时通过菜单命令进行。

  • 自动 ,每次文件更新时、启动调试会话之前或在向您的版本控制系统提交期间。

对于下载文件和文件夹,PyCharm 仅支持 手动 模式。

PyCharm 会在 文件传输 工具窗口中显示日志。

File Transfer 工具窗口

手动上传文件或文件夹

  • 项目 工具窗口(Alt+1 )中,右键点击一个文件或文件夹,然后在上下文菜单中选择 部署 | 上传到 ,并从列表中选择目标部署服务器或服务器组。

    手动上传文件或文件夹

    如果已指定默认服务器或服务器组,您也可以选择 上传到 <默认部署服务器或服务器组>

上传本地更改的文件

  1. 切换到 提交 窗口(Alt+0 )以查看本地更改的文件。

  2. 右键点击一个文件,然后在上下文菜单中选择 部署 | 上传到 ,并从列表中选择目标部署 。 如果已指定默认 组,您也可以选择 上传到 <默认部署 >

有关详细信息,请参阅 将文件添加到 Git 并跟踪更改

在与 VCS 存储库同步后上传文件

  1. Ctrl+T 或在主菜单中选择 VCS | <VCS> | 更新 ,将您的本地文件内容与 VCS 存储库同步。

  2. 切换到 更新信息 选项卡,该选项卡位于 版本控制 工具窗口 Alt+9

  3. 右键点击一个文件,然后在上下文菜单中选择 部署 | 上传到 ,并从列表中选择目标部署 。 如果已指定默认 ,您也可以选择 上传到 <默认部署 >

在提交后立即上传已提交的文件

  1. 提交 窗口(Alt+0 )中,点击 齿轮图标 以打开提交设置上下文菜单。

  2. 在菜单的 提交后 区域,从 将文件上传到 列表中选择目标服务器或服务器组。 选择现有配置之一或创建新配置:点击 浏览按钮 ,并在打开的对话框中 配置对相关服务器的访问 ,或 设置服务器组

    从提交后区域上传文件

    若要在将来自动应用您的选择,请选中 始终使用选定服务器或服务器组 复选框。

  3. 继续 提交您的更改

配置将更改的文件自动上传到默认服务器或服务器组

只要本地文件自动或手动保存(文件 | 全部保存Ctrl+S ),PyCharm 即视为该文件已更改,参见 处理源代码。 更改的文件只能自动上传到 默认部署服务器

  1. 通过以下任一方法打开 选项 对话框:

    • 转到 工具 | 部署(E) | 选项

    • 设置 对话框(Ctrl+Alt+S )中,转到 构建、执行、部署 | 部署 | 选项

  2. 自动将更改的文件上传到默认服务器(U) 列表中,选择让 PyCharm 何时上传已更改的文件:

    • 要上传任何手动或自动保存的文件,请选择 始终

    • 要仅上传手动保存的文件,请选择 显式保存操作时

    • 要禁用自动上传,请选择 从不

  3. 如果您启用了自动上传,可选地配置其适用范围:

    • 选择 跳过外部更改(X) ,以将使用第三方工具( VCS、脚本等 )所做的本地更改排除在自动上传之外。

    • 选择 本地删除后删除远程文件 ,使 PyCharm 在自动上传期间,如果本地文件被删除,则自动删除远程文件。

      请注意,此选项是额外的安全措施,可能会导致不需要的文件保留在远程服务器上。 例如,考虑一个本地文件 FILE.md ,将其重命名为 RENAMED.md 。 由于在技术上,重命名文件与删除该文件并创建一个新文件无法区分,因此在自动上传之后将发生以下情况:

      • 如果启用该选项,远程服务器将只包含 RENAMED.md

      • 如果禁用该选项,自动上传后,远程服务器将同时包含 FILE.md RENAMED.md 。 之后您可能需要手动删除 FILE.md

下载文件或文件夹

  1. 在主菜单中,转到 工具 | 部署 | 浏览远程主机

  2. 在打开的 远程主机 工具窗口中,选择所需的文件或文件夹,并从所选内容的上下文菜单中选择 从此处下载(D)

    下载文件或文件夹

从默认部署服务器下载文件

  • 在主菜单中,转到 工具 | 部署(E) | 从 <默认服务器> 下载

    如果存在本地文件,PyCharm 将提示您覆盖它们。

最后修改日期: 2025年 12月 2日