现已发布!阅读关于 12 月份的新功能和修复。

故障排除源代码管理

本文档可帮助您使用输出日志和跟踪日志记录来诊断和解决 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 命令的标准输出,除非发生错误。使用 git.commandsToLog 设置,您可以指定哪些 Git 命令应始终记录其标准输出,以获得更详细的诊断信息。

过滤和搜索 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.