WebStorm 2025.2 Help

Git

使用此页面设置将应用于项目中受 Git 控制的目录的版本控制设置。

Git 可执行文件路径

在此字段中指定 Git 可执行文件的路径。 输入路径或单击 浏览 浏览按钮 ,然后在打开的对话框中指定路径。

WebStorm 支持来自 Windows 子系统 Linux 2(WSL2)的 Git,该系统在 Windows 10 版本 2004 中可用。

如果 Windows 上未安装 Git,WebStorm 会在 WSL 中搜索 Git 并从那里使用它。 此外,当使用 \\wsl$ 路径打开项目时,WebStorm 会自动切换到来自 WSL 的 Git。

Windows 上对 Git 的 WSL2 支持

测试

单击此按钮以验证 Git 可执行文件的路径。

提交

启用暂存区

如果您更习惯于将更改 暂存 后再提交,而不是使用会自动暂存已修改文件的 变更列表 ,请启用此选项。

使用暂存区,您可以轻松将对同一文件的更改分别提交(包括重叠的更改),并且无需从编辑器切换焦点即可查看哪些更改已暂存。 有关更多信息,请参阅 使用 Git 暂存区提交更改

提交前警告 CRLF 行分隔符

选择此选项以启用对 LFCRLF 行分隔符的智能处理。 WebStorm 会分析您的配置,如果您即将将 CRLF 提交到版本库,则会发出警告,并建议将 core.autocrlf 设置更改为 trueinput ,具体取决于操作系统。

如果未选中此选项,您需要使用 差异查看器对话框 手动修复行结尾问题。

在 detached HEAD 或变基期间提交时显示警告

如果希望在您从 detached HEAD 或在变基期间执行提交时 WebStorm 显示警告(因为可能会引发问题并导致代码丢失),请选择此选项。

在向受保护分支推送 pick 的提交时添加“cherry-picked from <hash>”后缀

如果您希望在从 受保护分支 中拣选提交时保留对原始提交的引用,请选择此选项。 默认情况下,拣选更改时不会添加后缀。

配置 GPG 密钥

单击以配置用于签署提交的 GPG 密钥,或选择现有密钥。 有关更多信息,请参阅 使用 GPG 密钥签署提交

推送

当前分支的推送被拒绝时自动更新

如果希望当从当前分支向其跟踪分支执行的 push 操作被拒绝时能够自动更新当前分支,请选中此复选框。

如果未选中此选项,当由于本地版本库与远程存储不同步而拒绝 推送分支 时,WebStorm 将显示 推送被拒绝 对话框。

请注意以下事项:

  • 如果您之前从未看到过 推送被拒绝 对话框,并且首次启用复选框,WebStorm 将通过 merge 操作静默更新冲突的本地分支。

  • 如果您已看到 推送被拒绝 对话框,并选择了 记住更新方式选择… 选项,WebStorm 会保存您的上次选择 rebasemerge ,并将其应用于静默更新冲突的本地分支。

    相应地,若需更改“记住的”设置,请取消选中复选框,访问 推送被拒绝 对话框,选择 如果推送被拒绝则自动更新 选项,然后调用其他更新策略。

提交并推送后显示推送对话框

如果希望在 提交变更对话框 中点击 提交并推送 后显示 推送对话框 ,请启用此选项。 否则,变更将自动推送到受影响的版本库。

仅在提交至受保护分支时显示推送对话框

如果您仅希望在 提交更改对话框 中单击 提交并推送 并推送到受保护分支时显示 推送更改 对话框,请选择此选项。 否则,变更将自动推送到受影响的版本库。

受保护分支

若要禁用对某些分支 强制推送更改 的能力,请在此处列出(这是一个团队共享参数,存储在 .idea/vcs.xml 中)。

您可以使用分号分隔多个分支,也可以提供分支模式,因为输入将被视为正则表达式列表。

从 GitHub 加载分支保护规则

如果希望将 GitHub 的保护规则添加到 WebStorm,并在每次 fetch 时进行同步,请启用此选项。

更新

更新方法

使用此列表选择将本地版本库与远程存储同步的策略。 所选方法将在 push 操作被拒绝(已启用 当前分支的推送被拒绝时自动更新 选项)或当您调用 更新项目 操作时使用。 可用选项如下:

  • 合并 :选择此选项以在更新期间执行 merge。 这等同于依次运行 git fetchgit merge ,或运行 git pull --no-rebase

  • 变基 :选择此选项以在更新期间执行 rebase。 这等同于依次运行 git fetchgit rebase ,或运行 git pull --rebase (所有本地提交将被置于更新后的上游 head 之上)。

使用以下方式清理工作区

选择在执行项目更新时如何处理未提交的更改:

  • 储藏 :本地更改将保存至 git stash。 如果您需要在 WebStorm 之外应用包含暂存更改的补丁,此功能将十分有用,因为这些补丁是由 Git 生成的。

  • 搁置 :WebStorm 会将本地更改移至 shelf。 shelving 由 WebStorm 执行,且由 shelved 更改生成的补丁通常在 WebStorm 中应用。

按路径筛选更新项目信息

如果您不希望在执行 update 操作时,在 Update Info 选项卡中查看项目的所有更改信息,您可以按特定路径筛选列表。

显式检查远程上的传入提交

启用此选项后,WebStorm 会检查是否存在尚未获取到本地仓库的传入提交,并会在 分支 弹窗中标记此类分支。

选择 WebStorm 查询远程以检查传入提交的方式:

  • 自动 :如果使用 HTTP 或 Git 协议访问远程,WebStorm 将在后台检查更新。 如果使用 SSH,则不会执行此检查,以避免外部身份验证程序意外弹出。

  • 始终 :即使使用 SSH 访问远程,WebStorm 也会在后台检查更新。

  • 从不 :WebStorm 不会查询远程传入提交,会在 分支 弹窗中显示警告,允许您手动执行检查。

使用凭据助手

如果不希望覆盖 credential helpers (默认行为),请选择此选项。 您将能够在 Git 登录 对话框中使用凭据助手进行身份验证。

暂存

在一个选项卡中合并 stash 和 shelf

启用此选项后,您将能在 提交 工具窗口 Alt+0 所在的 储藏与搁置 选项卡中看到已 stash 和已 shelve 的更改。

调用“显示差异”时,比较 stashed 更改

在本节中,指定在查看 stashed 更改时,希望在差异查看器中显示的内容。

  • 使用文件的本地版本 :将 stashed 更改与所选文件的本地版本比较。 此选项为默认启用。

  • 使用父提交 :将 stashed 更改与父提交进行比较。

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