故障排除源代码管理
本文档可帮助您使用输出日志和跟踪日志记录来诊断和解决 Visual Studio Code 中的 Git 问题。当 Git 操作失败或行为异常时,请使用这些诊断工具。
Git 输出窗口
VS Code 使用您计算机上的 Git 安装来执行源代码管理操作。Git 输出窗口提供 VS Code 执行的 Git 命令的详细日志。此信息对于了解正在执行哪些 Git 操作以及诊断问题很有用。
打开 Git 输出窗口
-
在“源代码管理”视图中,选择 **...** 菜单,然后选择 **显示 Git 输出**
-
从命令面板运行 **Git: 显示 Git 输出** 命令(⇧⌘P (Windows, Linux Ctrl+Shift+P))
-
打开 **输出** 面板(⇧⌘U (Windows Ctrl+Shift+U, Linux Ctrl+K Ctrl+H)),然后从下拉菜单中选择 **Git**

Git 输出窗口显示:
- Git 扩展的当前日志级别
- 正在使用的 Git 可执行文件的位置
- VS Code 执行的 Git 命令
- 命令错误消息
- 每个命令的时间戳和持续时间
在 Git 操作失败或行为异常时查看此输出。这些信息有助于识别 Git 配置、身份验证或存储库状态方面的问题。
默认情况下,Git 输出窗口不会显示 Git 命令的标准输出,除非发生错误。使用 git.commandsToLog 设置,您可以指定哪些 Git 命令应始终记录其标准输出,以获得更详细的诊断信息。
过滤和搜索 Git 日志
Git 输出窗口可以生成大量信息。为了有效地查找相关条目,您可以使用以下技术:
-
使用输出面板中的下拉菜单按日志级别或日志类别过滤输出

日志级别包括:
trace、debug、info、warning、error。默认情况下,Git 输出窗口显示info级别及以上内容。日志类别根据正在记录的内容而变化,例如
git或repository。要查看正在运行的 Git 命令,请选择git类别。 -
使用输出面板中的搜索框搜索特定词语(⌘F (Windows, Linux Ctrl+F))
Git 输出窗口会突出显示搜索词语,并允许您在匹配项之间导航。搜索框支持正则表达式以进行高级搜索。

为 Git 扩展启用跟踪日志记录
为了获得更详细的诊断信息,您可以为 Git 扩展启用跟踪日志记录。跟踪日志记录提供有关扩展操作的详细信息,包括内部状态和详细的命令执行。
启用跟踪日志记录
-
打开 Git 输出窗口
-
在输出面板标题栏中选择齿轮图标,然后选择一个日志级别,例如
trace
选择日志级别时,VS Code 会记录该级别及更高级别的信息。例如,选择
trace会记录所有消息,而选择error则仅记录错误消息。
后续步骤
- 源代码管理常见问题解答 - 关于 Git 和源代码管理的常见问题解答
- 源代码管理概述 - 了解 VS Code 的源代码管理功能
- Git 文档 - 官方 Git 文档和资源