现已发布!阅读关于 11 月新增功能和修复的内容。

故障排除源代码管理

本文档可帮助您在 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”。

Screenshot of the Output panel showing the Git output channel.

Git 输出窗口显示:

  • Git 扩展的当前日志级别
  • 正在使用的 Git 可执行文件的位置
  • VS Code 执行的 Git 命令
  • 命令错误消息
  • 每个命令的时间戳和持续时间

当 Git 操作失败或行为异常时,请查看此输出。这些信息有助于识别 Git 配置、身份验证或存储库状态方面的问题。

提示

默认情况下,Git 输出窗口不会显示 Git 命令的 stdout,除非发生错误。通过 git.commandsToLog 设置,您可以指定哪些 Git 命令应始终记录其 stdout 输出以进行更详细的诊断。

过滤和搜索 Git 日志

Git 输出窗口可能会生成大量信息。为了高效地查找相关条目,您可以使用以下技术:

  • 使用输出面板中的下拉菜单按日志级别或日志类别过滤输出。

    Screenshot of the Output panel filter dropdown.

    日志级别包括:tracedebuginfowarningerror。默认情况下,Git 输出窗口显示 info 级别及以上的信息。

    日志类别会根据正在记录的内容而变化,例如 gitrepository。要查看正在运行的 Git 命令,请选择 git 类别。

  • 使用输出面板中的搜索框搜索特定词语(⌘F (Windows, Linux Ctrl+F))。

    Git 输出窗口会突出显示搜索词,并允许您在匹配项之间导航。搜索框支持正则表达式以进行高级搜索。

    Screenshot of the Output panel search box.

为 Git 扩展启用跟踪日志记录

为了获得更详细的诊断信息,您可以为 Git 扩展启用跟踪日志记录。跟踪日志记录提供有关扩展操作的详细信息,包括内部状态和详细的命令执行。

启用跟踪日志记录

  1. 打开 Git 输出窗口

  2. 选择输出面板标题中的齿轮图标,然后选择一个日志级别,例如 trace

    Screenshot of the Output panel log level selection.

    当您选择日志级别时,VS Code 将记录该级别及以上级别的消息。例如,选择 trace 将记录所有消息,而选择 error 只记录错误消息。

后续步骤

© . This site is unofficial and not affiliated with Microsoft.