使用 Visual Studio Code 进行开发

调试

首先，安装以下扩展

• Debugger for Firefox

注意: Debugger for Chrome 已被弃用。您可以安全地删除它，因为 Visual Studio Code 现在拥有 捆绑的 JavaScript 调试器，涵盖相同的功能。

在开始调试会话之前，请确保 Metabase 已构建并正在运行。选择菜单视图，命令面板，搜索并选择任务：运行生成任务。或者，使用相应的快捷键 Ctrl+Shift+B。内置终端将出现以显示进度，请稍候片刻，直到 webpack 指示捆绑完成 (100%)。

要开始调试 Metabase，请切换到调试视图（快捷键：Ctrl+Shift+D），然后从顶部的下拉列表中选择两个启动配置之一

• 使用 Firefox 调试，或
• 使用 Chrome 调试

之后，通过选择菜单运行，开始调试（快捷键：F5）开始调试会话。

有关更多详细信息，请参阅关于 调试 的完整 VS Code 文档。

基于 Docker 的工作流程

这些说明允许您在 Windows、Linux 或 macOS 上使用 Visual Studio Code 处理 Metabase 代码库，而无需手动安装必要的依赖项。这可以通过利用 Docker 容器和 VS Code 的 Remote Containers 扩展来实现。

有关更多详细信息，请遵循关于 在容器内开发 的完整 VS Code 指南。

要求

• Visual Studio Code（显然）
• Docker
• Remote - Containers 扩展 for VS Code

重要提示：确保 Docker 运行正常，并且可以用于下载镜像和启动容器，例如通过运行

$ docker run hello-world

如果一切顺利，您应该看到以下消息

Hello from Docker!
This message shows that your installation appears to be working correctly.

步骤

1. 克隆 Metabase 仓库

2. 启动 VS Code 并打开您克隆的 Metabase 仓库

3. 从视图菜单中，选择命令面板…，然后查找Remote-Container: Reopen in Container。（VS Code 也可能会弹出一个“在容器中打开”弹出窗口提示您执行此操作）。注意：VS Code 将首次创建容器，这可能需要一些时间。后续加载应该会快得多。

4. 使用菜单视图，命令面板，搜索并选择任务：运行生成任务（或者，使用快捷键 Ctrl+Shift+B）。

5. 一段时间后（在所有 JavaScript 和 Clojure 依赖项完全下载后），使用您的网络浏览器打开 localhost:3000。

有关使用 Docker 运行 Metabase 开发分支的更多信息，请参阅此处。