WebStorm 2025.2 Help

自定义上传和下载

除了确保在各种项目-服务器设置中成功上传和下载所需的强制设置外,您还可以配置其他选项,以自定义与服务器的交互方式。 这些选项中的大多数适用于所有 服务器访问配置类型。 对于 FTP、FTPS 和 SFTP 服务器配置,您可以指定其他特定协议的选项。

设置常用上传和下载选项

  1. Ctrl+Alt+S 打开设置,然后选择 构建、执行、部署 | 部署 | 选项

    或者,在主菜单中转到 工具 | 部署 | 选项...

  2. 指定其他设置:

    • 若要在上传和下载过程中跳过特定文件或整个文件夹,请在 通过名称排除项 字段中指定定义这些文件和文件夹名称的模式。

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

      例如,假设您有一个文件夹 stylesheets ,其中包含三个文件 style.css style1.css style2.scss ,则 style* 将排除整个文件夹, style?.css 将排除 style1.css ,而 style?.* 将排除 style1.css style2.scss

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

      详细了解请访问 Regular-Expressions.info

      排除操作将递归应用。 这意味着,如果匹配的文件夹包含子文件夹,这些子文件夹中的内容也不会被部署。

      有关详细信息,请参阅 从上传和下载中排除文件和文件夹

    • 通过选中或清除相应复选框,指定上传和下载过程的详细信息。

指定其他特定协议的自定义选项

  1. Ctrl+Alt+S 打开设置,然后选择 构建、执行、部署 | 部署

    或者,在主菜单中转到 工具 | 部署 | 配置

  2. 选择一个已配置的服务器,并在 连接 选项卡中展开 高级组,以指定取决于协议的其他上传设置:

    • 连接数(E) 字段中,指定可同时支持的最大连接数。

    • 发送保持活动消息的间隔(K) 字段中,指定希望 WebStorm 向服务器发送命令以重置超时从而保持连接的频率。

    • 客户端-服务器通信编码 (E) 字段中,指定与服务器使用的编码相匹配的编码。 如果无法确定服务器是否支持 UTF-8 编码,请接受默认值。

    • 若要将客户端设置为 被动模式 ,请选择 被动模式(P) 复选框。 在此模式下,您机器上的客户端连接到服务器以通知进入被动模式,接收要监听的端口号,并通过该端口建立数据连接。 当您的机器位于防火墙之后时,此模式非常有用。

    • 若要在 服务器浏览器工具窗口中显示隐藏文件和目录(名称以点 . 开头),请选择 显示并处理隐藏文件(S)

    • 使用LIST 命令 区域中选择 与旧版本的列示子项兼容(C) ,以确保与 FTP 服务器的 子文件命名兼容性

      如果远程 FTP 服务器报告如下错误,此选项将非常有用:

      Invalid descendant file name <file name>

      启用此选项可能会降低与服务器的同步速度。

    • 使用LIST 命令 区域中选择 代替MLSD ,以使用标准 LIST 命令进行列表列出,而不是使用 MLSD 命令。 这样可以避免出现问题,例如在上传过程中失败并抛出 Invalid descendent file name 异常(如果 FTP 服务器支持 MLSD 且返回 cdir)。

    • 连接数(E) 字段中,指定可同时支持的最大连接数。

    • 发送保持活动消息的间隔(K) 字段中,指定希望 WebStorm 向服务器发送命令以重置超时从而保持连接的频率。

    • 保持活动命令(A) 列表中选择要发送到服务器以重置超时从而保持连接的命令。

    • TLS :传输层安全性的方式。 选择 显式(X) 以使用与普通(非安全)模式相同的端口,或选择 隐式(I) 使用专用端口。

    • 数据通道保护级别(D) :选择 清除 建立非安全连接,或选择 Private 建立安全连接。

    • 重用SSL 会话 :选中以重用在 SSL 连接期间建立的安全契约,包括密钥和算法协议信息。

    • 禁用TLS 1.3 :选中以禁用 TLS 1.3 功能,让 WebStorm 回退通过 TLS 1.2 连接。 如果在连接服务器或上传某些文件时遇到问题,请使用此选项。

    • 若要将客户端设置为 被动模式 ,请选中 被动模式(P) 复选框。 在此模式下,您本地的客户端会连接到服务器,告知其处于被动模式,接收要监听的端口号,并通过接收到的端口建立数据连接。 当您的计算机处于防火墙之后时,此模式非常有用。

    • 如需在 Server Browser Tool Window中显示隐藏文件与目录(名称以点 . 开头),请选择 显示并处理隐藏文件(S)

    • 使用 LIST 命令 区域中选择 与旧版本的列示子项兼容(C) ,以确保与您的 FTP 服务器在子文件命名上的 兼容性

      如果远程 FTP 服务器报告以下错误,此选项会有所帮助:

      Invalid descendant file name <file name>

      选择此选项可能会减慢与服务器的同步速度。

    • 使用LIST 命令 区域中选择 代替MLSD ,以使用标准的 LIST 命令代替 MLSD 命令进行列出操作。 这样可以避免相关问题,例如,如果 FTP 服务器支持 MLSD 并返回 cdir ,则在上传过程中会因 无效的子文件名异常而失败。

最后修改日期: 2025年 9月 26日