故障排除源代码管理
本文旨在帮助您使用输出日志和跟踪日志来诊断并解决 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

Git 输出窗口会显示:
- Git 扩展的当前日志级别
- 所使用的 Git 可执行文件的位置
- 由 VS Code 执行的 Git 命令
- 命令错误消息
- 每个命令的时间戳和持续时间
当 Git 操作失败或行为异常时,请查看此输出。这些信息有助于识别 Git 配置、身份验证或存储库状态方面的问题。
默认情况下,除非发生错误,否则 Git 输出窗口不会显示 Git 命令的标准输出 (stdout)。通过 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 文档和资源