WebStorm 2025.2 Help

上传和下载文件

WebStorm 提供以下两种方式将项目文件和文件夹上传到 已配置的部署服务器

  • 手动 ,可随时通过菜单命令进行上传。

  • 自动 ,在每次更新文件、开始调试会话之前或执行版本控制系统提交期间上传。

对于下载文件和文件夹,WebStorm 仅支持 手动模式。

WebStorm 会在 文件传输 工具窗口中显示日志。

文件传输工具窗口

手动上传文件或文件夹

  • 项目 工具窗口(Alt+1 )中,右键单击某个文件或文件夹,然后从上下文菜单中选择 部署 | 上传到 ,并从列表中选择目标部署服务器或服务器组。

    手动上传文件或文件夹

    如果已指定默认服务器或服务器组,您也可以选择 上传到 <默认部署服务器或服务器组>

上传本地已更改的文件

  1. 切换到 提交 窗口(Alt+0 )以查看本地已更改的文件。

  2. 右键单击某个文件,然后从上下文菜单中选择 部署 | 上传到 ,并从列表中选择目标部署 。 如果已指定默认 组,您也可以选择 上传到 <默认部署 >

有关详情,请参见 将文件添加到 Git 并跟踪更改

与 VCS 仓库同步后上传文件

  1. Ctrl+T 或从主菜单中选择 VCS | <VCS> | 更新 ,将本地文件内容与 VCS 仓库同步。

  2. 切换到 更新信息 选项卡,在 版本控制 工具窗口 Alt+9 中查看。

  3. 右键单击某个文件,然后从上下文菜单中选择 部署 | 上传到 ,并从列表中选择目标部署 。 如果已指定默认 ,您也可以选择 上传到 <默认部署 >

提交后立即上传已提交的文件

  1. 提交 窗口(Alt+0 )中,点击 齿轮图标 以打开提交设置上下文菜单。

  2. 在菜单中的 提交后 区域,从 将文件上传到 列表中选择目标服务器或服务器组。 选择现有配置之一或创建新配置:点击 浏览按钮 ,然后 配置相关服务器的访问权限 ,或在打开的对话框中 设置服务器组

    从提交后区域上传文件

    若要以后自动应用所选内容,请选中 始终使用选定服务器或服务器组 复选框。

  3. 继续 提交更改

配置将更改的文件自动上传至默认服务器或服务器组

一旦本地文件被自动或手动保存(文件 | 全部保存Ctrl+S ),WebStorm 会将其视为已更改,参见 编写和编辑源代码。 更改的文件只能自动上传到 默认部署服务器

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

    • 转到 工具 | 部署(E) | 选项

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

  2. 自动将更改的文件上传到默认服务器(U) 列表中选择希望 WebStorm 在何时上传已更改的文件:

    将更改的文件自动上传至默认服务器
    • 要上传所有手动或自动保存的文件,请选择 始终

    • 要仅上传手动保存的文件,请选择 显式保存操作时

    • 要禁止自动上传,请选择 从不

  3. 如果启用了自动上传,您可以选择性地配置其适用范围:

    • 选中 跳过外部更改(X) ,以排除使用第三方工具(如 VCS、脚本等)所做的本地更改,使其不参与自动上传。

    • 选中 本地删除后删除远程文件 ,让 WebStorm 在自动上传时,如果本地文件被删除,也自动删除远程文件。

      请注意,此选项作为额外的安全措施,可能导致远程服务器上保留不需要的文件。 例如,请考虑一个本地文件 FILE.md ,其被重命名为 RENAMED.md 。 由于从技术上讲,重命名文件与删除该文件并创建一个新文件并无区别,因此在自动上传后将会发生以下情况:

      • 如果启用此选项,远程服务器将仅包含 RENAMED.md

      • 如果禁用此选项,远程服务器在自动上传后将同时包含 FILE.md RENAMED.md 。 随后,您可能需要手动删除 FILE.md

下载文件或文件夹

  1. 在主菜单中,转到 工具 | 部署 | 浏览远程主机

  2. 在打开的 远程主机 工具窗口中,选择所需文件或文件夹,并在其上下文菜单中选择 从此处下载(D)

    下载文件或文件夹

从默认部署服务器下载文件

  • 在主菜单中,转到 工具 | 部署(E) | 从 <default server> 下载

    若存在本地文件,WebStorm 将提示您是否覆盖。

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