PyCharm 2026.1 Help

Git 设置

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

Git 可执行文件路径

在此字段中,指定 Git 可执行文件的路径。 键入路径,或点击 浏览 "浏览" 按钮 ,并在打开的对话框中指定路径。

PyCharm 支持使用 Windows Subsystem for Linux 2(WSL2) 中的 Git,该功能在 Windows 10 版本 2004 中可用。

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

在 Windows 上对 Git 的 WSL2 支持

测试

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

提交

启用暂存区

如果您更习惯在提交前对更改进行 暂存 ,而不是使用会自动暂存已修改文件的 更改列表 ,请启用此选项。

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

在即将提交 CRLF 行分隔符时发出警告

选择此选项以启用对 LFCRLF 行分隔符的智能处理。 PyCharm 将分析您的配置;如果您即将把 CRLF 提交到存储库,将发出警告,并根据您的操作系统建议将 core.autocrlf 设置更改为 trueinput

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

在分离的 HEAD 或变基期间提交时发出警告

如果您希望在从分离的 HEAD 提交或在变基期间提交时,PyCharm 显示警告,因为这可能导致问题和代码丢失,请选择此选项。

在拣选已推送到受保护分支的提交时,添加 'cherry-picked from <hash>' 后缀

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

配置 GPG 密钥

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

推送

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

如果从当前分支到其跟踪分支的 push 操作被拒绝,并且您希望自动更新当前分支,请选中此复选框。

如果取消选择此选项,当由于本地存储库与远程存储不同步而导致 推送分支 被拒绝时,PyCharm 将显示 推送被拒绝 对话框。

请注意:

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

  • 如果您已经遇到过 推送被拒绝 对话框并选择了 记住更新方法的选择... 选项,PyCharm 会保存您上次选择的 rebasemerge ,并将其用于静默更新发生冲突的本地分支。

    因此,要更改 "remembered" 设置,请清除此复选框,打开 推送被拒绝 对话框,选择 如果推送 ... 被拒绝,则自动更新 选项,并调用其他更新策略。

在执行提交并推送时显示推送对话框

如果您希望在 提交更改 对话框中点击 提交并推送 后显示 推送对话框 ,请选择此选项。 否则,您的更改将自动推送到受影响的存储库。

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

如果您只希望在将更改推送到受保护的分支时,才在 提交更改 对话框中点击 提交并推送 后显示 推送更改 对话框,请选择此选项。 否则,您的更改将自动推送到受影响的存储库。

受保护分支

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

您可以列出多个分支,以分号分隔;或者提供分支模式,因为输入将被视为正则表达式列表。

从 GitHub 加载分支保护规则

如果您希望将 GitHub 保护规则添加到 PyCharm,并在每次获取时同步它们,请选择此选项。

更新

更新方法

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

  • 合并 :选择此选项可在更新期间执行 合并。 这相当于先运行 git fetch ,再运行 git merge ,或 git pull --no-rebase

  • 变基 :选择此选项可在更新期间执行 变基。 这相当于先运行 git fetch ,再运行 git rebase ,或 git pull --rebase (所有本地提交都会被放到更新后的上游 head 之上)。

使用以下方式清理工作树

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

  • 贮藏 :本地更改将保存到 git stash。 如果您需要在 PyCharm 之外使用已贮藏的更改应用补丁,这将很有用,因为这些补丁由 Git 自身生成。

  • 搁置 :PyCharm 会将本地更改放到 搁置。 搁置由 PyCharm 完成,由已搁置的更改生成的补丁通常在 PyCharm 内应用。

按路径筛选"更新项目"信息。

如果在执行 更新 时,您不希望在 更新信息 选项卡中获取项目的所有更改信息,您可以按特定路径筛选列表。

自动获取远程更改

每 20 分钟启用一次后台获取远程更新。 使用此功能可跟踪传入更改。

可通过 git.update.incoming.info.time 注册表项配置间隔。

检查远程以获取传入更改

启用此选项时,PyCharm 会检查是否有尚未获取到本地仓库的待处理传入提交,并会在 VCS 微件中标记这些分支。

获取标签

指定从远程获取时 PyCharm 应如何处理标记:

  • 自动 :遵循 Git 配置中定义的默认行为。

  • 同步--prune-tags ):从远程获取所有标记,并删除本地在远程仓库中已不存在的标记。

  • 始终--tags ):强制从远程获取所有标记。

  • 从不--no-tags ):完全禁用标记获取。

使用凭据助手

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

贮藏

在同一选项卡中合并储藏与搁置

如果您希望在 提交 工具窗口(Alt+0 )的名为 贮藏和搁置 的选项卡中同时查看 已贮藏已搁置 的更改列表,请启用此选项。

调用 "显示差异" 时,比较已贮藏的更改

在本部分中,请指定在调查已贮藏的更改时您希望在差异查看器中看到的内容。

  • 使用文件的本地版本 :已贮藏的更改将与所选文件的本地版本进行比较。 此选项默认启用。

  • 使用父提交 :已贮藏的更改将与父提交进行比较。

2026年 3月 24日