WebStorm 2026.3 Help

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

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

在以下情况下,可能需要排除文件和文件夹:

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

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

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

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

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

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

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

  1. 通过以下任一方式打开 部署 对话框:

    • 在主菜单中选择 工具 | 部署 | 配置。

    • 在 设置 对话框(Ctrl+Alt+S )中,选择 部署 下的 构建、执行、部署。

  2. 在 部署 对话框中,单击 排除路径 选项卡。 该选项卡显示先前已排除的本地和远程文件夹列表。

  3. 单击 添加 按钮 "添加"按钮 ,然后选择 部署路径。

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

  5. 在添加的行末尾,点击 浏览 按钮 “浏览”按钮。

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

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

  7. 当您点击 确定 时,您将返回 Excluded Paths 选项卡,所选的远程文件夹将被添加到列表中。

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

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

  2. 在打开的 远程主机 工具窗口中,从列表中选择相应的 服务器配置。

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

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

  1. 通过以下任一方式打开 部署 对话框:

    • 在主菜单中选择 工具 | 部署 | 配置。

    • 在 设置 对话框(Ctrl+Alt+S )中,选择 部署 下的 构建、执行、部署。

  2. 在 部署 对话框中,单击 排除路径 选项卡。 该选项卡显示先前已排除的本地和远程文件夹列表。

  3. 单击 添加 按钮 "添加"按钮 ,然后选择 本地路径。

  4. 在添加行的末尾,点击 浏览 按钮 浏览按钮 并导航到您想要排除的文件夹。

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

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

  1. 通过执行以下操作之一打开 Options对话框:

    • 转到 工具 | 部署 | 选项。

    • 在 设置 对话框(Ctrl+Alt+S ),转到 构建、执行、部署 | 部署 | 选项。

  2. 在打开的 选项 对话框中,指定在 按名称排除项目 字段中定义这些文件和文件夹名称的模式。

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

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

    使用通配符排除:整个文件夹样式表从部署中排除
    使用通配符排除:问号
    使用通配符排除:问号和星号

    详细了解请参阅 Regular-Expressions.info。

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

请移除排除标记

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

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

2026年 11月 6日