故障排除源代码管理

本文旨在帮助您使用输出日志和跟踪日志来诊断并解决 Visual Studio Code 中的 Git 问题。当 Git 操作失败或出现异常行为时,请使用这些诊断工具。

Git 输出窗口

VS Code 使用您机器上安装的 Git 来执行源代码管理操作。Git 输出窗口提供了由 VS Code 执行的 Git 命令的详细日志。这些信息有助于了解正在执行哪些 Git 操作以及诊断问题。

要打开 Git 输出窗口:

  • 在“源代码管理”视图中,选择 ... 菜单,然后选择 显示 Git 输出

  • 从命令面板(⇧⌘P (Windows, Linux Ctrl+Shift+P))运行 Git: Show Git Output 命令

  • 打开 输出 面板(⇧⌘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 在 VS Code 中打开 在 VS Code Insiders 中打开 设置,您可以指定哪些 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.