从上传/下载中排除文件和文件夹

对包含源代码的文件或文件夹禁用上传、下载和同步，可确保源代码免受意外更新。将其应用于非源代码时，可以节省系统资源，因为媒体、缓存或临时文件将不再被不必要地复制。

在以下情况下，您可能需要禁止上传/下载：

您将使用外部创建并上传的源代码。要在 PyCharm 中处理这些远程源代码，您必须先将其下载并组织到项目中。不过，有些源代码完全不应更新。另一方面，远程主机上的文件夹也可能包含大量媒体、缓存、临时文件，而这些其实并非您的工作所需。
您已经从服务器下载了数据，并将其整理到一个 PyCharm 项目中。但是，出于某些原因，您需要保护服务器上的某些文件或文件夹不被上传/下载，例如防止意外覆盖。
应用程序的本地副本既包含源代码，也包含您无需上传的其他数据。此外，您希望保护某些源代码，避免被误覆盖。在这种情况下，您可以对所有不应上传的文件和文件夹禁用上传/下载。

从上传/下载中排除文件夹有两种方式：

显式方式：在远程主机工具窗口或部署对话框的排除的路径选项卡中，将相应路径标记为已排除。
1. 所有未被排除的文件夹和文件名都会以绿色背景显示。被排除项的名称显示为无背景。
2. 在远程主机工具窗口中，您既可以排除整个文件夹，也可以排除特定文件。
按名称，即在选项对话框的按名称排除项字段中指定确定名称的模式，以排除文件和文件夹。

在创建项目后，从上传/下载中排除服务器上的文件夹

将文件夹添加到排除路径列表

通过以下任一方式打开部署对话框：
- 在主菜单中选择工具 | 部署 | 配置。
- 在设置对话框（Ctrl+Alt+S ）中，在构建、执行、部署下选择部署。
在部署对话框中，点击排除路径选项卡。该选项卡显示之前已排除的本地和远程文件夹列表。
点击添加按钮，然后选择部署路径。
双击添加到列表中的空行。
在添加的行末，点击浏览按钮。
在选择要排除的远程路径对话框中，导航到您要排除的文件夹。
您也可以手动输入路径，但请注意，仅接受绝对路径。
点击确定后，将返回排除的路径选项卡，所选远程文件夹会被添加到列表中。

在远程主机工具窗口中，将文件夹添加到排除路径列表

在主菜单中，转到工具 | 部署 | 浏览远程主机或视图 | 工具窗口 | 远程主机。
在打开的远程主机工具窗口中，从列表中选择相应的服务器配置。
选择要排除的文件夹，并在其上下文菜单中选择排除路径。

从上传/下载中排除本地文件夹

通过以下任一方式打开部署对话框：
- 在主菜单中选择工具 | 部署 | 配置。
- 在设置对话框（Ctrl+Alt+S ）中，在构建、执行、部署下选择部署。
在部署对话框中，点击排除路径选项卡。该选项卡显示之前已排除的本地和远程文件夹列表。
点击添加按钮，然后选择本地路径。
在添加的行末，点击浏览按钮，并导航到您要排除的文件夹。
您也可以手动输入路径，但请注意，仅接受绝对路径。

按名称从上传/下载中排除文件和文件夹

通过以下任一方式打开选项对话框：
- 转到工具 | 部署 | 选项。
- 在设置对话框（Ctrl+Alt+S ），转到构建、执行、部署 | 部署 | 选项。
在打开的选项对话框中，在按名称排除项字段中指定定义这些文件和文件夹名称的模式。
使用分号 ; 作为分隔符，星号 * 用于匹配零个或多个字符，问号 ? 用于匹配单个字符。
例如，如果您有一个文件夹 stylesheets ，其中包含三个文件 style.css 、 style1.css 和 style2.scss ，则 style* 排除整个文件夹， style?.css 排除 style1.css ，而 style?.* 排除 style1.css 和 style2.scss 。
了解更多内容，请参阅 Regular-Expressions.info。
该排除会递归应用。这意味着，如果匹配的文件夹具有子文件夹，这些子文件夹的内容也不会部署。

移除排除标记

选择要上传/下载的文件或文件夹，并在其上下文菜单中选择从排除项中移除路径。
将文件夹恢复为可上传/下载会影响其所有子文件夹和文件。

2026年 7月 14日