# 排除文件和文件夹的上传和下载

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

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

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

1.  处理在 IntelliJ IDEA 之外创建并上传的源代码。 下载所需文件并将其作为项目打开。 排除不应更新的源文件，以及不需要的远程媒体、缓存或临时文件。

2.  已从服务器下载文件，并在 IntelliJ IDEA 中将其作为项目打开。 排除文件或文件夹，以防止之后的上传或下载覆盖要保留的副本。

3.  本地应用程序包含服务器不需要的源代码和其他文件。 排除这些文件，使其不被上传，并排除传输期间不应被覆盖的任何源文件。

在部署配置中使用   排除的路径   来排除特定文件或文件夹。 在部署选项中使用   按名称排除项目  ，以跨配置排除匹配的文件名和文件夹名称。

> **Note:**
> 排除项控制 IntelliJ IDEA 中的文件传输。 排除项不会更改文件权限，也不会限制对服务器上文件的访问。

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

* 明确地通过在 [Remote Host](remote-host-tool-window.html) 工具窗口或 [Excluded Paths](deployment-excluded-paths-tab.html) 选项卡中的 [Deployment 对话框](settings-deployment.html) 中将相应路径标记为已排除。 1. 所有未被排除的文件夹和文件名都显示在绿色背景上。 已排除项目的名称显示时没有背景。 2. 在 [Remote Host](remote-host-tool-window.html) 工具窗口中，您可以排除整个文件夹和特定文件。

* 按名称 ，即通过在 [确定文件和文件夹名称的模式](#exclude_by_name)中，指定要从 按名称排除项目 字段的 [选项](settings-deployment-options.html)对话框中排除的项目。

> **Note:**
> 在任何情况下，排除都是递归应用的。 如果文件夹的路径被明确标记为排除或文件夹名称符合模式，则其所有子文件夹（如果有）的内容也将被保护，避免上传/下载。
>
>
>
> 还请注意，仅通过 [按名称排除](#exclude_by_name)，可以保护  单独的文件 免于上传/下载。

Procedure: 启用 FTP/SFTP/WebDAV Connectivity 插件

此功能依赖于 [FTP/SFTP/WebDAV Connectivity](https://plugins.jetbrains.com/plugin/13125-ftp-sftp-webdav-connectivity)插件，该插件默认在 IntelliJ IDEA 中捆绑并启用。 如果相关功能不可用，请确保您没有禁用插件。

> **Note:**
> 在未订阅 Ultimate 版的情况下，IntelliJ IDEA 中无法使用 FTP/SFTP/WebDAV 连接插件。

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

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

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

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

1. 通过以下任一方式打开 [部署](settings-deployment.html) 对话框：

* 从主菜单中选择 `工具 | 部署 | 配置` 。

* 在 设置 对话框（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))）中，选择 部署 下的 构建、执行、部署 。

2. 在 [部署](settings-deployment.html) 对话框中，点击 [排除路径](deployment-excluded-paths-tab.html) 选项卡。 该选项卡显示先前已排除的本地和远程文件夹列表。

3. 点击   添加   按钮 !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，然后选择   部署路径  。

4. 双击添加到列表中的空行。

5. 在添加的行末尾，点击   浏览  按钮 ![浏览按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.open.svg)。

6. 在   选择远程排除路径  对话框中，导航到您想要排除的文件夹。

您也可以手动输入路径，但请注意仅接受绝对路径。

7. 当您点击   OK   时，您将返回 [Excluded Paths](deployment-excluded-paths-tab.html) 选项卡，所选的远程文件夹将被添加到列表中。

Procedure: 在 Remote Host 工具窗口中将文件夹添加到排除路径列表

1. 在主菜单中，前往  `工具 | 部署 | 浏览远程主机`  或  `视图｜工具窗口｜远程主机`  。

2. 在打开的 [远程主机](remote-host-tool-window.html) 工具窗口中，从列表中选择相应的 [服务器配置](creating-in-place-server-configuration.html)。

3. 选择要排除的文件夹并从选择的上下文菜单中选择   排除路径  。

## 排除本地文件夹的上传/下载

Procedure:

1. 通过以下任一方式打开 [部署](settings-deployment.html) 对话框：

* 从主菜单中选择 `工具 | 部署 | 配置` 。

* 在 设置 对话框（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))）中，选择 部署 下的 构建、执行、部署 。

2. 在 [部署](settings-deployment.html) 对话框中，点击 [排除路径](deployment-excluded-paths-tab.html) 选项卡。 该选项卡显示先前已排除的本地和远程文件夹列表。

3. 点击   添加   按钮 !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，然后选择   本地路径  。

4. 在添加行的末尾，点击   浏览  按钮 ![浏览按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.open.svg)并导航到您想要排除的文件夹。

您也可以手动输入路径，但请注意仅接受绝对路径。

## 通过名称排除文件和文件夹的上传/下载

Procedure:

1. 通过执行以下操作之一打开 [Options](settings-deployment-options.html)对话框：

* 前往 `工具 | 部署 | 选项` 。

* 在 设置 对话框（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))），转到 `构建、执行、部署 | 部署 | 选项` 。

2. 在打开的 [选项](settings-deployment-options.html) 对话框中，指定在   按名称排除项目   字段中定义这些文件和文件夹名称的模式。

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

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

详细了解请参阅 [Regular-Expressions.info](https://www.regular-expressions.info/quickstart.html)。

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

## 请移除排除标记

Procedure:

* 选择要上传或下载的文件或文件夹，并从上下文菜单中选择   从排除中移除路径  。

返回一个文件夹进行上传/下载会影响其所有子文件夹和文件。

## See also

### 语言和框架特定指南

[将文件部署到服务器](deploying-applications.html) [自定义上传和下载](customizing-upload.html)

### 参考

[部署：排除路径选项卡](deployment-excluded-paths-tab.html) [选项](settings-deployment-options.html) [部署](settings-deployment.html) [远程主机工具窗口](remote-host-tool-window.html)