查找并修复代码中的 bug 可能会令人沮丧(尤其是在你是新开发人员时)。 值得庆幸的是,诸如 GitHub Copilot 工具可以快速识别和挤压 bug,让你专注于更具创造性、有趣的工作。
先决条件
本文中的示例假定你在 (GitHub Copilot) 中调试Visual Studio CodePython项目VS Code。 若要按照这些示例操作,需要:
- 完成文档中的设置Visual Studio Code。CopilotVisual Studio Code
- Download Python。
- 安装Python扩展。Visual Studio Code
学习通过示例进行调试
尝试运行有 bug 的代码时,你会遇到两个主要情况:
- 代码在完成运行之前退出,并且你会收到一条错误消息。
- 代码运行时没有错误,但是输出与你预期的不同。
值得庆幸的是, Copilot 这两种情况下都可以帮助调试代码。 若要了解如何操作,请完成以下示例。
使用 调试错误 GitHub Copilot
运行有 bug 的代码时,你通常会收到一条错误消息。 该消息告知你发生错误的文件和行,并简要描述问题所在。 但是,错误消息可能会令人困惑。 为了充分了解和修复 bug,我们可以寻求帮助 Copilot 。
让我们通过一个示例仓库试试看:new2code/debug-with-copilot。
克隆示例存储库
首先,需要创建该仓库的本地副本:
- 开始在 中克隆 new2code/debug-with-copilot 存储库。VS Code
- ** **选择在计算机上保存存储库的位置,然后单击“选择为存储库目标”。
- 出现提示时,打开存储库。
运行存在 bug 的文件
接下来,我们运行 bugged_dice_battle.py 文件。 此程序模拟两名玩家之间的骰子对战。
-
在 VS Code中,打开并查看
bugged_dice_battle.py文件。 -
按Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(Mac)打开命令面板。
-
输入
Terminal: Create New Terminal并按 Enter 键。 -
在终端选项卡中,粘贴以下命令。
Windows:
Shell py bugged_dice_battle.py
py bugged_dice_battle.pyMac 或 Linux:
Shell python bugged_dice_battle.py
python bugged_dice_battle.py -
按 Enter 运行程序。
遗憾的是,我们的终端显示了一些错误信息,并出现以下消息:
TypeError:只能将 str(而非“int”)连接到 str
调试文件
若要了解此错误的含义, 请打开 副驾驶聊天 , VS Code然后粘贴并发送以下提示:
Explain in depth why my code produces the following error and how I can fix it: TypeError: can only concatenate str (not "int") to str
Explain in depth why my code produces the following error and how I can fix it:
TypeError: can only concatenate str (not "int") to str
Copilot 将响应错误,因为我们尝试连接整数 die_1 和 die_2 字符串,并且只能将字符串连接到字符串。
它还将提供一个我们代码的更新版本,该版本通过使用**** 函数将整数转换为字符串,然后再进行连接,从而修复bugstr()。 通过将建议应用于 Copilot文件来练习调试的最后一步。
使用 调试错误的输出 GitHub Copilot
有时,有 bug 的代码运行时不会引发任何错误,但输出显然不正确。 在这种情况下,调试可能更加困难,因为 VS Code 无法告诉你 bug 的位置或说明。
对于这些“不可见”bug, Copilot 特别有用。 让我们通过示例仓库中的另一个文件来动手实践一下:bugged_factorial_finder.py。 这是一个用于计算阶乘的Python程序。
运行存在 bug 的文件
首先,我们来运行这个程序,看看它输出的错误结果:
-
打开并查看
bugged_factorial_finder.py文件。 -
在之前创建的终端中,粘贴以下命令。 Windows:
Shell py bugged_factorial_finder.py
py bugged_factorial_finder.pyMac 或 Linux:
Shell python bugged_factorial_finder.py
python bugged_factorial_finder.py -
按 Enter 运行程序。
遗憾的是,代码未按预期工作。 我们希望它返回 720,即 6 阶乘的正确值,但输出远高于此。
调试文件
若要了解出错的原因, 请打开 副驾驶聊天 并发送以下提示:
Why is the output of this code so much higher than expected? Please explain in depth and suggest a solution.
Why is the output of this code so much higher than expected? Please explain in depth and suggest a solution.
Copilot将指出,因为我们正在使用*=运算符,因此实际上乘以factorial两者。factorial``i 换句话说,对于循环的每个迭代,我们都会乘以额外的 factorial。
若要修复此错误, Copilot 将建议从公式中删除额外的 factorial 代码,或将 *= 运算符更改为 =。 立即进行更改!
调试自己的项目
现在,你已练习调试一些简单的程序 Copilot,你可以使用相同的方法查找和修复隐藏在你自己的工作中的错误。
例如,若要调试代码生成的错误消息,请发送 Copilot 以下提示:
Explain in depth why my code produces the following error and how I can fix it: YOUR-ERROR-MESSAGE
Explain in depth why my code produces the following error and how I can fix it:
YOUR-ERROR-MESSAGE
否则,如果要调试不正确的输出,请询问 Copilot 输出为何不正确,以及如何修复它。 为了获得最佳结果,请提供尽可能多的上下文,说明输出与你的期望有何不同。
借助这些策略,你完全有能力开始清除项目中的 bug 了!
后续步骤
随着你继续编码,你可能会遇到难以调试的特定问题场景和错误。 有关潜在问题和示例 副驾驶聊天 提示的列表,请参阅 调试中出现的错误。