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

从上传、下载和同步中排除文件和文件夹，以防止文件传输期间意外更新。排除不需要的媒体、缓存和临时文件还可以减少不必要的传输和资源使用。

在以下情况下，您可能需要排除文件和文件夹：

您处理的是在 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年 11月 3日