debug-locally-with-vscode.md

使用VSCode进行本地调试

• 概述
• 启动 VSCode
• 启动机器人
• 配置 VSCode
• 连接调试器
• 调试机器人

概述

如果你想要调试你的机器人，你能用棒棒的 Bot Framework 模拟器。另一个选项是安装 VSCode 并使用 Bot Builders 的 TextBot 类来调试你运行在命令行窗口中的机器人。这份向导将指引你做这件事。

启动 VSCode

为了指引你，我们将使用 Bot Builders 的 TodoBot 示例。当你把 VSCode 安装在你的电脑上后，你需要用“打开文件夹”选项打开你的机器人项目。

启动机器人

TodoBot 被设计来跨平台地运行机器人，这是能够在本地调试你的机器人的关键。为了在本地调试，你需要一个能用 TextBot 类在命令行窗口中运行的机器人的版本。在 TodoBot 这个例子中，我们能通过启动 textBot.js 类来本地运行。为了正确地用 VSCode 调试这个类我们希望能用 --debug-brk 参数启动 node，这能使它瞬间暂停。所以我们在一个控制台窗口中运行node --debug-brk textBot.js。

配置 VSCode

在你能调试你当前暂停的机器人之前，你需要配置 VSCode 的 node 调试器。VSCode 知道你的工程使用 node 但是对于怎样启动 node 还需要很多可能的配置，所以需要你为每个工程（也就是文件夹）做一个一次性的配置。为了配置调试器，选择左边下面的调试选项卡然后按下绿色的运行按钮。VSCode 会让你选取你的调试环境，你可以直接选择 "node.js"。默认的设置就适合你的目的，所以你不需要调整其他的。你会看到有一个 .vscode 文件夹添加进了你的工程，如果你不想这个被收入 Git 仓库，你可以添加一条 /**/.vscode 到你的 .gitignore 文件中。

连接调试器

配置调试器会导致添加了两种调试模式，Launch(启动) 和 Attach(连接)。因为我们的机器人已经被暂停在了命令行窗口，我们会选择"Attach"(连接)模式然后再次按下绿色的运行按钮。

调试机器人

VSCode 会连接到你的暂停的机器人，到第一行代码上；现在你已经准备好设定断点并调试你的机器人了！你的机器人能通过命令行交流，所以切换会你的机器人运行着的命令行窗口并说"hello"吧。