WebStorm 2025.2 Help

版本控制集成支持

WebStorm 在两个层级上支持版本控制集成:

  • 在 IDE 层级,通过一组默认启用的 捆绑插件 提供 VCS 集成。

  • 在 项目 层级,通过将 项目 文件夹与一个或多个版本控制系统关联来启用 VCS 集成。

将项目根目录关联至版本控制系统

WebStorm 允许您快速启用项目与版本控制系统的集成,并将其与项目根目录关联。 有关将不同项目目录与不同版本控制系统关联的详细信息,请参阅 将目录关联至版本控制系统

  1. 按下 Alt+` 打开 VCS 操作弹出窗口 并选择 启用版本控制集成

    或者,前往 VCS | 启用版本控制集成

  2. 在打开的 启用版本控制集成 对话框中,选择要与 项目文件夹 关联的版本控制系统。

  3. 启用 VCS 集成后,WebStorm 将询问您是否希望通过 VCS 共享项目设置文件。 您可以选择 始终添加 与使用 WebStorm 的其他存储库用户同步项目设置。

    提示选择如何处理配置文件的通知

    请注意,此功能仅适用于 Git 和 Mercurial。

有关后续步骤,请参阅:

配置目录映射

WebStorm 支持基于目录的版本控制模型,这意味着每个项目目录都可与不同的版本控制系统关联。

将目录关联至版本控制系统

  1. 按下 Ctrl+Alt+S 打开设置,然后选择 版本控制 | 目录映射

  2. 目录映射 页面显示项目目录及其关联的版本控制系统列表(若未添加任何目录,则列表仅包含项目根目录)。

  3. 点击右侧的 添加 按钮

  4. 在打开的 添加 VCS 目录映射 对话框中,选择 目录 选项。 输入要与版本控制系统关联的目录路径,或点击 浏览 按钮 “浏览”按钮 ,在打开的对话框中选择目录。

  5. VCS 列表中,选择用于控制此目录中文件的版本控制系统。 请注意,此列表仅包含已启用对应 插件 的版本控制系统。

  6. 点击 确定 保存映射并返回 目录映射 页面。

管理未注册目录

对于启用了 Git 或 Mercurial 集成的项目,WebStorm 将扫描项目目录,以检查是否存在未由 IDE 控制的 Git/Mercurial 仓库。 若检测到此类仓库,WebStorm 将显示通知。

如需添加未注册根目录,请点击通知中的 添加根目录 链接。 或者,打开 Version Control 设置页面 ,选择要添加的未注册根目录(这些目录为空灰色),并执行 将目录关联至版本控制系统 中的操作。

如果您不希望再次收到这些根目录的通知,请点击通知中的 忽略 链接。 请注意,如果向项目添加新的未注册仓库,WebStorm 将通知您。

更改 VCS 关联

  1. 按下 Ctrl+Alt+S 打开设置,然后选择 版本控制 | 目录映射

  2. 目录映射 页面显示项目目录及其关联的版本控制系统列表(若未添加任何目录,则列表仅包含项目根目录)。

  3. 找到与您希望放入另一版本控制系统的目录对应的行。

  4. 点击 VCS 列。 在出现的列表中选择新的版本控制系统。

  5. 点击 确定 保存映射并返回 目录映射 页面。

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