断点

使用 Wrangler 或 Vite 在本地开发 Worker 时，可以通过断点进行调试。断点让您能够查看 Worker 执行过程中特定点的状态。DevTools 和 VS Code 均支持断点功能。

有关通过 Chrome DevTools 进行断点调试的更多信息，请参阅 Chrome 关于断点的文章 ↗。

使用 VSCode 内置的 JavaScript Debug Terminals ↗，只需打开 JS 调试终端（Cmd + Shift + P，然后输入 javascript debug），并在调试终端中运行 wrangler dev（或 vite dev）。VSCode 会自动连接到正在运行的 Worker（即使同时运行多个 Worker！）并开始调试会话。

要在 Worker 项目中设置 VS Code 断点调试：

1. 如果项目根目录中尚不存在 .vscode 文件夹，请创建一个。
2. 在该文件夹中创建包含以下内容的 launch.json 文件：

{
	"configurations": [
		{
			"name": "Wrangler",
			"type": "node",
			"request": "attach",
			"port": 9229,
			"cwd": "/",
			"resolveSourceMapLocations": null,
			"attachExistingChildren": false,
			"autoAttachChildProcesses": false,
			"sourceMaps": true // works with or without this line
		}
	]
}

3. 在 VS Code 中打开项目，从 VS Code 打开新的终端窗口，并运行 npx wrangler dev 启动本地开发服务器。

4. 在 Run & Debug（运行和调试） 面板顶部，您应能看到选择配置的选项。选择 Wrangler，然后点击播放图标。Wrangler: Remote Process [0] 应显示在左侧的 Call Stack 面板中。

5. 返回项目中的 .js 或 .ts 文件，添加至少一个断点。

6. 在浏览器中打开 Worker 的本地 URL（默认为 http://127.0.0.1:8787）。断点应被命中，您可以在指定行查看代码详情。

• 本地开发 — 通过 Wrangler 和 workerd ↗ 在本地开发 Workers 及关联资源，获得快速、准确的反馈循环。