PyCharm 2025.3 Help

Git 设置

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

Git 可执行文件的路径

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

PyCharm 支持来自 适用于 Linux 的 Windows 子系统 2(WSL2)的 Git,该组件在 Windows 10 version 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 内应用。

按路径筛选更新项目信息

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

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

如果启用此选项,PyCharm 将检查是否存在尚未获取到本地存储库的待处理传入提交,并会在 分支 弹出窗口中标记这些分支。

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

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

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

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

使用凭据助手

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

贮藏

将贮藏与搁置合并到一个选项卡中

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

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

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

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

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

最后修改日期: 2025年 12月 2日