PyCharm 2025.2 Help

Git 设置

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

Git 可执行文件路径

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

PyCharm 支持来自 Linux 子系统 2 (WSL2) 的 Git,适用于 Windows 10 版本 2004

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

Windows 上对 WSL2 的 Git 支持

测试

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

提交

启用暂存区

如果您更习惯于在提交前通过 staging更改而不是使用 changelists (此方法会自动暂存修改的文件),请启用此选项。

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

如果即将提交 CRLF 行分隔符,请警告

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

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

在分离的 HEAD 状态或变基期间提交时警告

选择此选项,如果您希望 PyCharm 在从脱离的 head 或进行 rebase 时执行提交操作时显示警告,因为这可能会导致问题和代码丢失。

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

如果您希望在从 protected branch进行cherry-picking时保留对原始commit的引用,请选择此选项。 默认情况下,摘樱桃操作不会添加后缀。

配置 GPG 密钥

点击以配置 GPG Key 来签署您的提交或选择现有的密钥。 欲了解更多信息,请参阅 使用 GPG 密钥签署提交

推送

如果当前分支的推送被拒绝,则自动更新

如果当前分支到其跟踪分支的 push 操作被拒绝,选择此复选框以自动更新当前分支。

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

请注意以下几点:

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

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

    因此,要更改“记住”的设置,请取消选中复选框,访问 推送被拒 对话框,选择 如果推送……被拒绝,自动更新 选项,然后调用另一个更新策略。

显示提交和推送的推送对话框

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

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

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

受保护的分支

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

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

从 GitHub 加载分支保护规则

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

更新

更新方法

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

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

  • Rebase :选择此选项以在更新期间执行 rebase。 这相当于运行 git fetch 然后 git rebase ,或者 git pull --rebase (所有本地提交将会被放置在更新后的上游头部之上)。

使用 清理 工作树

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

  • 储藏 :本地更改将保存到一个 git stash。 如果您需要在 PyCharm 之外应用带有暂存更改的补丁,这会很有用,因为它们是由 Git 自行生成的。

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

按路径过滤更新项目信息

如果您不希望在执行 更新时在 Update Info标签中获得有关项目所有更改的信息,您可以通过指定路径筛选列表。

明确检查远程上的传入提交

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

选择如何让 PyCharm 查询远程以检查传入的提交:

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

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

  • 从不 :PyCharm 不会查询远程是否有传入的提交,且 分支 弹出窗口内会显示警告,允许您手动运行检查。

使用凭据助手

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

储藏

在一个选项卡中合并暂存和搁置

如果您希望在一个名为 储藏和搁置 的选项卡中看到 暂存搁置 的更改,请启用此选项。这些更改会显示在 提交 工具窗口 Alt+0 中。

调用“显示差异”时,比较储藏的更改

在本节中,指定在调查储藏更改时希望在差异查看器中看到的内容。

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

  • 与父提交 :储藏的更改与父提交进行比较。

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