日志选项卡

只有在您使用 Git 或 Mercurial 进行版本控制时，此选项卡才可用。

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

该选项卡包含以下窗格：

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

分支窗格

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

分支窗格工具栏

图标	操作	说明
	隐藏 Git 分支	隐藏分支窗格。
	新建分支	基于所选分支创建新分支。
	更新所选	获取所选分支的更改。
	删除分支	删除所选分支
	与当前比较	比较所选分支与当前检出的分支。
	显示我的分支	筛选列表，仅显示由您创建的分支。
	获取所有远程	获取所有远程分支的更改。
	标记/取消标记为收藏	将所选分支标记为收藏。收藏的分支显示在列表顶部。
	按目录分组	按目录对分支进行分组。
	全部展开/全部折叠	展开/折叠列表

分支窗格上下文菜单

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

提交窗格

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

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

棕色：标记已关闭的分支
黄色：标记 tip（存储库中的最新修订）
紫色：标记书签
绿色：标记打开的分支

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

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

提交旁的星号表示作者与提交更改的用户不同的提交。

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

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

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

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

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

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

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

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

提交窗格上下文菜单

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

项目	说明
复制修订号	将所选提交的修订号复制到剪贴板。
创建补丁	基于所选提交创建补丁。
移植（Mercurial）	将所选提交的更改应用到当前分支。
更新到修订	将您的工作副本父修订更改为所选提交。新提交将从您更新到的修订（提交）继续。
新建分支	基于所选提交创建新分支。
新建标签	将新标签添加到所选提交。
分支 <branch_name> / 分支	此命令会出现在所有指向所选提交的分支上（如果只有一个分支，则为分支 <branch_name> ，若有多个分支，则为分支），并提供与分支弹出窗口和分支窗格的上下文菜单中相同的选项。如果启用了同步控制存储库选项，且所选分支在多个存储库中存在，则会出现名为在所有存储库中的其他菜单选项，允许您在所有存储库中同时执行相同操作。
MQ	使用此子菜单管理 Mercurial 队列：导入：使用此命令将所选变更集转换为补丁。转到补丁：使用此命令打开 MQ: <project_name> 选项卡，其中显示尚未应用的补丁队列。重命名补丁：使用此命令重命名所选补丁。完成补丁：使用此命令将所选补丁转换为永久变更集。

更改的文件窗格

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

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

上下文菜单命令

项目	说明
显示差异 `Ctrl+D`	点击以打开文件差异查看器，您可以在其中将所选文件的当前修订与之前的修订进行比较。
与本地比较	将所选提交中该文件的修订与其当前本地版本进行比较。
将之前的修订与本地比较	将该文件在所选提交之前的修订与其当前本地修订进行比较。
编辑源代码 `F4`	打开所选文件的本地副本进行编辑。
打开存储库版本	点击以打开所选文件的存储库版本进行编辑。
还原所选更改	点击以回滚所选文件中的更改。当您只需回滚特定文件的更改，而不是丢弃整个提交时，此选项非常有用。回滚所选文件的更改将被放入活动更改列表。
拣选所选更改	点击以应用所选更改到当前分支。
此处之前的历史	为所选文件打开历史选项卡，以便浏览该文件的所有修订历史。
显示对父项的更改	对于合并提交，显示相对于两个父项的更改，以便查看合并结果，并在合并过程中查看冲突究竟是如何解决的。

提交详情

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

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

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

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

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