PyCharm 2025.3 Help

选项

使用此页面指定用于将项目文件上传到本地和远程服务器以及从中下载的其他配置设置。 有关各种服务器访问配置的更多信息,请参阅 部署

此对话框中指定的选项适用于所有已定义的服务器配置,而不考虑服务器类型(本地、远程)和所用的数据传输协议。 针对 FTP/SFTP/FTPS/WebDAV 类型服务器配置的特定于协议的选项在 设置 对话框的 部署 页面上的 连接选项卡 中定义。

说明

通过名称排除项

在此字段中,指定不需要部署的文件和文件夹名称模式。

使用分号 ; 作为分隔符,使用星号 * 匹配零个或多个字符,使用问号 ? 匹配单个字符。

例如,如果您有一个文件夹 stylesheets ,其中包含三个文件 style.css style1.css style2.scss ,则 style* 会排除整个文件夹, style?.css 会排除 style1.css ,而 style?.* 会排除 style1.css style2.scss

Regular-Expressions.info 上了解更多信息。

排除会递归应用。 这意味着,如果匹配的文件夹包含子文件夹,这些子文件夹的内容也不会被部署。

操作记录(O)

使用此列表指定您需要的日志详细程度。 可用选项包括:

  • 仅错误 :选择此选项可使日志仅显示上传期间发生的错误。

  • 简要 :选择此选项可在日志中反映所有事件,但不包含详细信息。

  • 详细 :选择此选项可在日志中显示有关上传的更多详细信息,例如完整文件路径。

覆盖最新文件(W)

选中此复选框后,无论自上次上传以来是否已更改,都会上传所有文件。

否则,如果未选中此复选框,则仅上传自上次上传以来已更改的文件。

在上传期间使用临时文件

选中此复选框后,正在上传到服务器的已更改文件将使用临时名称,且仅在上传操作成功完成后才将其改回原名。

&保留文件时间戳

选中此复选框可防止在上传时重置文件的时间戳。

当源项不存在时删除目标项(从“项目”视图或“远程主机”视图传输时)(D)

选中此复选框后,若目标目录中的某个文件未包含在本次上传中,则会将其移除。

当从 项目 工具窗口或 远程主机 工具窗口执行同步时,此选项适用。

创建空目录(C)

选中此复选框后,如果自上次在源文件夹上传以来您的项目中新建了本地目录,将在服务器上自动创建一个空目录。

覆盖或删除本地项时提示(R)

选中此复选框后,执行下载期间的同步操作、覆盖或删除本地条目之前,PyCharm 将提示确认。

确认上传文件

选中此复选框后,在将本地条目上传到远程主机之前,PyCharm 将提示确认。

自动将更改的文件上传到默认服务器(U)

在此列表中,选择您希望 PyCharm 何时将文件自动上传到默认服务器或服务器组。 可用选项包括:

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

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

  • 从不 :禁止自动上传。

部署 页面上,通过在列表中选择所需项目并点击 用作默认值 工具栏按钮 将 Web 服务器配置设为默认的图标 来指定默认服务器配置或服务器组。

跳过外部更改(X)

选中此复选框可将使用第三方工具( VCS、脚本等)所做的本地更改从自动上传中排除。

仅当在 自动将更改的文件上传到默认服务器(U) 列表中选择了 始终显式保存操作时 选项时,此复选框才可用。

本地删除后删除远程文件

选中此复选框后,若本地文件已被删除,PyCharm 会在自动上传期间自动删除远程文件。 仅当在 自动将更改的文件上传到默认服务器(U) 列表中选择了 始终显式保存操作时 选项时,此复选框才可用。

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

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

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

保留原始文件权限

如果启用该选项,PyCharm 将在通过 FTP/FTPS 向远程主机上传文件时保留本地文件的原始权限。

该选项仅适用于 macOS 和 Linux。

重写文件的默认权限(V)

选中此复选框可更改在远程主机上分配给已上传文件的默认权限。 点击 浏览 浏览按钮 打开 文件默认权限 对话框,您可以通过分配权限来管理远程主机上已上传文件的访问权限。

重写文件夹的默认权限(I)

选中此复选框可更改在远程主机上分配给已上传文件夹的默认权限。 点击 浏览 浏览按钮 打开 文件夹默认权限 对话框,您可以通过分配权限来管理远程主机上已上传文件夹的访问权限。

在有更新的文件情况下进行上传时发出警告(N)

使用此列表定义将文件上传到远程主机时应用的版本控制策略。 根据此选择,PyCharm 要么检查自您下载以来远程主机上的相应文件是否有任何更改,要么直接覆盖远程文件。

  • :选择此选项可在不提示的情况下,用其本地副本覆盖远程主机上的文件。 自上次同步以来对远程文件所做的所有更改都将被放弃。

  • 比较时间戳和大小 :如果选择此选项,PyCharm 将执行两项检查:

    1. 比较本地和远程文件的大小。

    2. 比较上次同步时设置的远程文件时间戳与当前远程文件时间戳。

    如果文件大小不同或远程文件的时间戳不同,PyCharm 将打开 文件差异查看器 ,您可以在其中查看并合并差异。

    此类检查取决于时区设置。 如果您本机的时区设置与远程主机不同,即使文件版本实际上不同,检查也可能被判定为成功。

  • 比较内容 :选择此选项时,PyCharm 将比较本地和远程文件的内容。 如果检测到任何差异,PyCharm 将打开 文件差异查看器 ,您可以在其中查看并合并差异。

通知远程更改(H)

选中此复选框可接收有关远程主机上更改的通知。 仅当在 在有更新的文件情况下进行上传时发出警告(N) 列表中选择了 比较时间戳和大小比较内容 选项时,此复选框才可用。

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