日志选项卡

此选项卡显示所有本地与远程分支，以及已提交到所有分支或某个特定分支或存储库的所有更改。

该选项卡包含以下窗格：

分支窗格位于左侧，显示所有本地和远程分支。在此窗格中，您可以在分支之间切换、创建新分支并删除不再需要的分支、按分支筛选日志等。
提交窗格位于工具窗口的中央部分，显示所有分支或所选分支的提交。
更改的文件窗格位于工具窗口右侧，显示所选提交中修改的文件列表。
提交详情窗格位于右侧的更改的文件窗格下方，显示所选提交的详细信息。

分支窗格

分支窗格列出所有本地和远程分支，并允许您执行所有分支操作。

分支窗格工具栏

图标	操作	描述
	隐藏 Git 分支	隐藏分支窗格。
	新建分支	基于所选分支创建新分支。
	更新所选	获取所选分支的更改。
	删除分支	删除所选分支。
	与当前比较	比较所选分支与当前检出的分支。
	显示我的分支	筛选列表，仅显示由您创建的分支。
	获取所有远程	获取所有远程分支的更改。
	标记/取消标记为收藏	将所选分支标记为收藏。收藏的分支显示在列表顶部。
	导航日志到所选分支头部	跳转回所选分支的 `HEAD`。
	分支窗格设置	选择单击时要执行的操作：更新分支筛选器：自动更新提交列表，仅显示所选分支的历史记录。导航日志到分支头部：跳转回所选分支的 `HEAD`。按目录分组：按目录对分支进行分组。显示标签：在分支列表中将标记显示为单独的节点。
	全部展开/全部折叠	展开/折叠列表

分支窗格上下文菜单

项目	描述
检出	检出所选分支。
从 <selected_branch> 新建分支	基于所选分支创建新分支。
检出并变基到 <current_branch>	将所选分支变基到当前检出分支之上。
与 <current_branch> 比较	比较所选分支与当前检出的分支。
显示与工作树的差异	将所选分支与当前检出分支的本地状态进行比较。
将 <current_branch> 变基到 <selected_branch>	将当前检出分支变基到所选分支之上。这相当于使用所选分支名称运行 `git rebase`。
将 <selected_branch> 合并到 <current_branch>	将所选分支合并到当前检出分支。这相当于使用所选分支名称运行 `git merge`。
从 <selected_branch> 新建工作树	从所选分支创建 Git 工作区。
使用变基拉取到 <current_branch>	从所选分支获取更改，并将当前分支变基到这些更改之上。
使用合并拉取到 <current_branch>	从所选分支获取更改，并将其合并到当前分支。
更新	拉取所选分支的更改。您可以选择多个分支以批量更新它们。
推送	推送传出提交到所选分支。
重命名	重命名所选分支。
删除	删除所选分支。您可以选择多个分支以批量删除它们。

提交窗格

此区域显示所选分支或所有分支的所有提交列表。对于每个提交，列表显示提交消息、作者以及提交时间戳。每个分支中的最新提交都会带有一个标签，标注其所在分支的名称。

黄色：标记当前分支头
绿色：标记本地分支
紫色：标记远程分支

当前分支的提交显示在淡蓝色背景上，而其他所有分支的提交显示在白色背景上。

您所做的提交以粗体显示。

提交旁边的星号用于标记作者与提交更改的用户不同的提交。

点击箭头可跳转到长分支中的下一个提交：

您也可以按 Left 和 Right 键以跳转到父/子提交。当不同存储库与多个分支的提交都混在版本控制工具窗口的日志选项卡 Alt+9 中时，这尤其有用。

在多存储库项目中，左侧的彩色条指示所选提交属于哪个根（每个根都用其自身的颜色标记）。将鼠标悬停在彩色条上以显示根路径的提示。

如果您希望使用完整的根名称展开根列，也可以启用显示根名称选项。

已提交的更改列表通常对应于跟踪系统中的问题。您可以直接从提交窗格在浏览器中跳转到此类问题。仅在满足以下条件时可用：

在问题导航设置偏好设置对话框中指定了缺陷跟踪系统的模式。
提交消息中包含相应的问题编号。

配置问题导航后，提交消息中的问题编号将呈现为链接。点击此类链接会将您带到问题跟踪器中的相应页面。

项目	工具提示与快捷键	描述
搜索字段	不适用	使用此字段在提交列表中进行搜索。您可以输入完整的提交名称或消息，或其片段、修订号或正则表达式。要完成搜索，请按 `Enter` ，或将焦点移出搜索字段。按 `Ctrl+L` 可快速将焦点切换到搜索字段。点击以显示先前的搜索模式。点击可清除搜索。
`.* / Cc`	正则表达式 / 区分大小写	点击以选择以下文本筛选器设置：正则表达式：在搜索字段中输入的任何内容都将被视为正则表达式，例如， `#\d+`。区分大小写：仅统计大小写匹配的条目。
分支	不适用	按分支或收藏的分支筛选提交。如果您想查看所有本地和远程分支的提交，请选择全部。
用户	不适用	按作者筛选提交。要查看特定作者的所有提交，请点击选择并开始键入作者姓名。要查看所有用户的提交，请选择全部。
日期	不适用	按时间范围或特定日期筛选提交。要查看在特定日期进行的提交，请点击选择并指定日期。要查看所有日期的提交，请选择全部。
路径	不适用	对于具有单个根的项目，按文件夹筛选提交；对于多根项目，按根与文件夹筛选提交。要查看对特定文件夹的提交，请点击选择文件夹并指定文件夹名称。对于多存储库项目，您还可以在根部分中选中一个或多个根旁边的复选框。
	图选项	自定义提交图的显示方式：默认情况下，提交会按按提交日期排序。也可以按以拓扑方式排序，更方便地查看合并，即在合并提交下方优先显示传入的提交。通过选择显示第一个父项仅显示第一个父级，或无合并过滤掉合并提交，可简化图表，便于单独查看更改。折叠线性分支：启用此选项可将图中的所有分支折叠，使图中以虚线代替连续的提交。您也可以通过点击它来折叠单个已展开的分支。展开线性分支：启用此选项可展开所有已折叠的分支，在图中显示连续的提交。您也可以通过点击它来展开单个已折叠的分支。
	启用 Git 日志索引	启用后，此选项可改进在 PyCharm 中处理更改历史的体验：快速筛选日志并计算精确的历史记录。修订文件历史记录中的分支筛选器。在随处搜索中跨历史记录进行搜索。
	刷新 `Ctrl+F5`	刷新提交列表。
	拣选（Git）	将所选提交的更改应用到当前分支。如果当前分支已包含所选提交，此按钮将被禁用。
	呈现设置	点击以调出选项列表，您可以在日志选项卡（属于版本控制工具窗口 `Alt+9` ）中配置数据的呈现方式。显示：紧凑引用视图：启用此选项后，单个提交的分支引用将以折叠视图显示：如果您想将每个分支引用在一行中展开，请取消选择此选项：标签名称：如果您希望除标签图标外还显示标签名称，请启用此选项：如果禁用此选项，您仍可将鼠标悬停在标签图标上查看标签名称。长边：启用此选项后，即使分支中没有提交，也会完整显示长分支。如果禁用此选项（默认），长分支将替换为向下箭头。提交时间戳：如果您希望 PyCharm 在日志视图中显示提交时间戳，而不是更改的作者时间，请启用此选项。在左侧显示引用：启用此选项可在提交消息左侧查看分支引用。显示根目录名称：如果您希望在多存储库项目中展开左侧的根列以显示完整的根名称，请启用此选项。列：自定义日志中的列。您可以选择日志是否显示由 CI 系统执行的作者、 date、提交哈希和 GitHub 提交检查。高亮显示：我的提交：粗体合并提交：灰显当前分支：蓝色背景未拣选的提交：灰显（仅适用于 Git）。未拣选的提交是指来自所选分支但尚未应用到当前分支的提交。
	转到哈希/分支/标签 `Ctrl+F`	点击此按钮并指定您要跳转到的哈希、标签或分支。您可以从不同存储库中选择同名引用。每个存储库的名称会与其颜色指示器一起显示在右侧。

提交窗格上下文菜单

项目	描述
复制修订号	将所选提交的修订号复制到剪贴板。
创建补丁	基于所选提交创建补丁。
拣选	将所选提交的更改应用到当前分支。
检出修订	检出所选提交中记录的文件状态。
在修订处显示存储库	在 Project 视图中打开所选修订的项目快照。
与本地比较	将所选提交时存储库的状态与您本地工作副本中的当前状态进行比较。
将当前分支重置到此处	将当前分支的头指针重置到所选提交。在打开的 Git 重置对话框中，选择更新工作树的模式。
还原提交	回滚所选提交中的更改。将创建一个新提交，以回滚所选提交中的更改。
撤销提交	在所选提交中，还原更改。此命令仅适用于由您创建的提交。
编辑提交消息	对所选提交，修改消息。此操作仅适用于尚未推送的提交。
修复	将已暂存的更改添加到所选提交，而不是创建单独的提交。仅保留原始提交的提交消息。
压缩到	将已暂存的更改添加到所选提交，而不是创建单独的提交。将保留两个提交的消息。
丢弃提交	在当前分支丢弃已推送的提交，不会留下任何操作痕迹。
压缩提交	合并所选提交，以获得更清晰的分支历史。
从此处开始交互式变基	编辑当前分支的历史，方法是对所选提交之后的所有提交执行交互式变基。
推送所有到此处	如果你有一些已提交但尚未想要推送到远程分支的提交，请选择你想要推送的最后一个提交，然后推送所有到此处。
将提交添加到远程分支	选择提交并将其拣选到任意远程分支。
将 <current_branch> 变基到所选提交	将当前检出分支变基到所选提交上。
分支 <branch_name> / 分支	此命令会出现在所有指向所选提交的分支上（如果只有一个分支，则为分支 <branch_name> ，如有多个分支，则为分支），并提供与 VCS 微件和分支窗格上下文菜单中相同的选项。如果启用了同步控制存储库选项，且所选分支在多个存储库中存在，则会出现名为在所有存储库中的其他菜单选项，允许您在所有存储库中同时执行相同操作。
新建分支	基于所选提交创建新分支。
新建标签	添加新标签到所选提交。
转到子提交	跳转到此分支中的下一个提交。
转到父提交	跳转到此分支中的上一个提交。
在浏览器中查看	在浏览器中打开与所选提交对应的页面。

已更改的文件窗格

此窗格显示当前所选提交中修改的文件列表。

项目	工具提示与快捷键	描述
	显示差异 `Ctrl+D`	打开文件差异查看器，您可以在其中将所选文件的本地版本与其存储库版本进行比较。
	回退所选更改	回滚更改在所选文件中。
	此处之前的历史	为所选文件打开历史选项卡，以便浏览该文件的所有修订历史。
	查看选项	按目录或模块对已修改的文件进行分组。配置布局：显示详细信息：显示提交详情窗格。显示差异预览：打开预览差异窗格，您可以在其中浏览所选已修改文件与其存储库版本之间的差异。
	全部展开/全部折叠 `Ctrl+NumPad +`	点击此按钮以展开/折叠所有节点。注意，这些按钮仅在启用树视图时可用。

上下文菜单命令

项目	描述
显示差异 `Ctrl+D`	点击以打开 Diff Viewer for files ，您可以在其中将所选文件的当前修订与上一修订进行比较。
在新窗口中显示差异	点击以在独立窗口中打开文件差异查看器。
与本地比较	将所选提交中该文件的修订与其当前本地版本进行比较。
将之前的修订与本地比较	将该文件在所选提交之前的修订与其当前本地修订进行比较。
编辑源 `F4`	打开所选文件的本地副本进行编辑。
打开存储库版本	点击以打开所选文件的存储库版本进行编辑。
回退所选更改	点击以回滚所选文件中的更改。当您只需回滚特定文件的更改，而不是丢弃整个提交时，此选项非常有用。回滚所选文件的更改将被放入活动更改列表。
拣选所选更改	点击以应用所选更改到当前分支。
将所选更改提取为单独的提交	如果需要将已提交的更改拆分为多个提交，可以将所选文件中的更改提取为单独的提交。
丢弃所选更改	如果在多个文件中提交了更改，现在想在推送提交前回滚部分更改，可以只丢弃部分更改，而不是整个提交。
创建补丁	从所选文件创建补丁。
从修订中获取	将文件回滚到所选修订中的状态。
此处之前的历史	为所选文件打开历史选项卡，以便浏览该文件的所有修订历史。
显示对父项的更改	对于合并提交，显示相对于两个父项的更改，以便查看合并结果，并在合并过程中查看冲突究竟是如何解决的。

提交详情

此区域在启用 Show Details 选项时显示。

此区域显示提交列表中所选提交的详细信息，例如提交消息、哈希、作者、指向作者电子邮件的链接、日期、时间、 GPG 签名、根目录和分支。

如果所选提交包含在超过六个分支中，仅显示前六个，并会出现显示全部链接，您可以点击该链接以展开完整的分支列表。

如果提交信息引用了另一个提交，您可以点击该提交的哈希值，在日志中跳转到该提交。

工作原理

2026年 7月 14日