使用 Visual Studio Code 进行开发

调试

首先,安装以下扩展

注意: Chrome 调试器已弃用。您可以安全地将其删除,因为 Visual Studio Code 现在已捆绑 JavaScript 调试器,涵盖相同的功能。

在开始调试会话之前,请确保 Metabase 已构建并正在运行。选择菜单“视图”(View),“命令面板”(Command Palette),搜索并选择“任务:运行构建任务”(Tasks: Run Build Task)。或者,使用相应的快捷键 Ctrl+Shift+B。内置终端将显示进度,请稍等片刻,直到 webpack 指示捆绑完成 (100%)。

要开始调试 Metabase,请切换到“调试”视图(快捷键:Ctrl+Shift+D),然后从顶部的下拉菜单中选择以下两个启动配置之一

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

之后,选择菜单“运行”(Run),“开始调试”(Start Debugging)(快捷键:F5)以开始调试会话。

欲了解更多详细信息,请参阅 VS Code 关于调试的完整文档。

基于 Docker 的工作流

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

欲了解更多详细信息,请遵循 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. 从“视图”(View)菜单中,选择“命令面板…”(Command Palette…),然后找到“远程容器:在容器中重新打开”(Remote-Container: Reopen in Container)。(VS Code 也可能通过“在容器中打开”弹出窗口提示您执行此操作)。注意: VS Code 将首次创建容器,这可能需要一些时间。后续加载应该快得多。

  4. 使用菜单“视图”(View),“命令面板”(Command Palette),搜索并选择“任务:运行构建任务”(Tasks: Run Build Task)(或者,使用快捷键 Ctrl+Shift+B)。

  5. 稍等片刻(待所有 JavaScript 和 Clojure 依赖项完全下载后),用您的网页浏览器打开 localhost:3000。

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

阅读 Metabase 其他版本的文档。

© . All rights reserved.