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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. 通过以下任一方式打开 [Deployment](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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))）中，选择 部署 下的 构建、执行、部署 。

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

3. 请点击   Add  按钮 ![添加按钮](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. 当您点击   确定   时，您将返回 [Excluded Paths](deployment-excluded-paths-tab.html) 选项卡，所选的远程文件夹将被添加到列表中。

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

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

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

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

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

Procedure:

1. 通过以下任一方式打开 [Deployment](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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))）中，选择 部署 下的 构建、执行、部署 。

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

3. 请点击   Add  按钮 ![添加按钮](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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))) 中，前往 `构建、执行、部署 | 部署 | 选项` 。

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

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

例如，如果您有一个文件夹  `样式表` 包含三个文件  `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)

