排查常见部署问题

部署速度慢或失败

部署可能是资源密集型操作，特别是在项目或部署服务器包含大量目录和文件的情况下。 在 设置 对话框（Ctrl+Alt+S ）中，导航到 构建、执行、部署 并查看以下配置选项，以加快部署速度：

• 从部署中排除不必要的目录（例如 images）。 可以在 部署：排除路径选项卡 页面完成此操作。

• 在 选项 页面上，取消选中 覆盖最新文件(W) ，以跳过上传不需要的文件。

• 根据服务器情况，在高级 FTP 设置中切换主动和被动传输模式可能会有所帮助。 可在服务器的 部署：连接选项卡 中切换 被动模式(P) 来完成。

文件传输无响应

此情况可能出现在 WebStorm 尝试通过 IPv6 解析 IPv4 主机时。 默认情况下，WebStorm 仅监听传入的 IPv4 连接。 为确保已禁用 IPv6，请检查 WebStorm 的 JVM options：

无法使用下载／上传操作

下载／上传操作可能由于未配置映射而不可用。 如果您要下载的文件或文件夹未在任何映射中配置，WebStorm 将不会下载它。 可以按照 3． 将项目文件夹映射到服务器文件夹和 URL 路径 中所述配置映射。

对于某些操作，需要在 部署 页的 设置 对话框中选择默认部署服务器。

某些文件夹未部署

文件夹未部署的常见原因之一是此类文件夹被显式排除。 为解决此问题，在 远程主机工具窗口 中右键单击该文件夹，并从上下文菜单中选择 从排除的对象中移除路径(L)。 完成此操作后，该文件夹将被部署。

这也可以通过 部署 页的 设置 对话框进行配置（Ctrl+Alt+S）。 打开该服务器的 排除的路径 选项卡并移除被排除的路径。 请注意，源文件夹和目标文件夹都应进行检查。 也可以在 选项 页的 通过名称排除项 下，通过名称排除某些文件夹。

在项目之间共享部署配置

部署服务器是在 IDE 级别配置的：它们适用于所有项目，并可在项目间共享。

请注意，仅有名称和连接详细信息（在 部署：连接选项卡 选项卡中指定）在项目之间共享：映射和排除路径是特定于项目的，必须分别配置。 采用此方法时，只需输入一次连接详细信息，而映射和排除路径可以按项目分别配置，并共享连接详细信息。 当多个项目共用同一个部署服务器并使用相同连接设置时，此方法非常有用。 如果项目之间的连接设置不同，则必须为每个项目分别配置。

如有需要，您可以通过在 部署：连接选项卡 中选中 仅对此项目可见 复选框，将某个服务器设为仅在单个项目中可见。

IDE 设置不允许配置映射

新建项目默认设置 用于配置新建项目的默认设置，并不会影响当前已打开的项目。 如需配置当前项目的设置，请使用 设置 对话框 Ctrl+Alt+S。

同一文件夹内的子文件夹能否具有不同的部署设置？ 本地文件夹能否部署到多个位置？

在上传文件夹和配置映射时，请注意以下事项：

• 您可以为特定文件夹指定映射至部署服务器上的不同路径。 这可以在服务器的 部署：映射选项卡 中配置。

• 您可以排除特定文件夹和文件，使其不上载／下载。 这可以在服务器的 部署：排除路径选项卡 中进行配置。

• 无法将同一个文件夹（或其子文件夹）同时上传至多个站点。 需要为它们中的每一个创建单独的部署配置，并分别上传至每个站点。

如果这正是您的需求，您可以使用 与已部署版本同步... 命令，并在每次上传时从可用部署服务器中进行选择。

无法为“与部署到我的服务器同步”菜单项分配快捷键

无法将快捷键直接分配给 与已部署内容同步到 <server name> 命令，只能分配给通用的 与已部署版本同步 命令，其将显示包含服务器列表的弹出菜单。 如需了解详情，请参阅 配置键盘快捷键。

如果您确实希望将快捷键分配给某个特定的部署服务器，可以录制一个宏并为其分配快捷键，方法如下：

上传前是否能在文件上运行脚本或可执行文件？

执行 压缩 CSS 、优化图像等操作通常建议在执行上传之前完成。 最佳方法是在文件更改时使用 WebStorm 中的 文件监视器 来运行这些操作，而不是在开始上传时。 在需要将其上传至部署服务器时，应上传经过处理的文件。

请注意，为使其生效，必须取消选中 跳过外部更改(X) 复选框，该选项位于 选项 页面中。

有时文件不会自动上传

默认情况下，如果文件被外部进程更改（如 VCS、转译器等），WebStorm 会上传这些文件。 如果未上传文件，请确保 自动将更改的文件上传到默认服务器(U) 在 选项 页面中被设置为 始终 ，并取消选中 跳过外部更改(X) 复选框。

我可以运行部署前或部署后的操作吗？

可以使用运行／调试配置实现此功能。 您可以创建一个虚拟运行／调试配置，或者将运行／调试配置设置为最后一步，并在 执行前(B) 下添加所需步骤。

FTP 问题：无效的后代文件名“http:”

配置部署服务器或在项目设置中使用 测试连接(C) 按钮时，会显示错误 Invalid descendent file name "http:"。 请注意，所有包含冒号 ： 的文件名将被视为无效。

如果项目中存在名称中包含 http: 的文件，则可能会发生此问题。 WebStorm 用于连接 FTP（Apache Commons VFS）的库无法读取包含此类文件的文件夹内容，因此操作失败。 唯一的解决方案是从项目中移除名称中包含 http: 的文件。

WebStorm 似乎已连接到服务器但无法列出文件或执行上传操作

这可能是由于部署服务器需要所谓的被动 FTP 连接。 要设置此模式，请在所选服务器的 部署：连接选项卡 中选中 被动模式(P) 复选框。

使用 Git checkout 切换分支时部署文件

切换 Git 分支时使用 Git checkout 部署文件，有几种方式可供选择：

• 一种方式是配置部署始终上传文件及外部更改。 为此，请在 选项 页面中，将 自动将更改的文件上传到默认服务器(U) 设置为 始终 ，并取消选中 跳过外部更改(X) 复选框。 请注意，在切换分支时，所有文件都将被上传到服务器。

• 使用 git-ftp。 它执行最小化上传，并能够同步文件和目录的删除。

WebStorm 无法与 FTPS 服务器建立连接

如果 FTPS 服务器配置为使用 TLS 1.0 / TLS 1.1，则 WebStorm 无法连接该服务器，并会显示以下错误信息：

这是因为 WebStorm 支持通过 TLS 1.2 及更高版本连接服务器。 使用 TLS 1.0 和 TLS 1.1 不受支持，因为这些协议 已弃用 并被认为不安全。

作为变通方法，您可以通过调整 WebStorm 的 JVM options 来启用 TLS 1.0 / TLS 1.1 支持。 请注意，使用过时的协议可能会并且确实会对您的环境造成安全风险，因此应作为最后手段。