使用Visual Studio Code进行开发

调试

首先安装以下扩展

注意:Chrome调试器已被弃用。您可以安全删除它,因为Visual Studio Code现在有一个内置的JavaScript调试器,它涵盖了相同的功能。

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

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

  • 使用Firefox进行调试
  • 使用Chrome进行调试

之后,通过选择菜单运行开始调试(快捷键:F5)来开始调试会话。

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

基于Docker的工作流程

这些说明允许您使用Visual Studio Code在Windows、Linux或macOS上工作在Metabase代码库上,无需手动安装必要的依赖项。这是通过利用Docker容器和VS Code的远程容器扩展实现的。

有关更多详细信息,请参阅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. 视图菜单,选择命令面板…然后找到远程容器:在容器中重新打开。注意:VS Code可能还会通过“在容器中打开”弹出窗口提示您这样做。VS Code将首次创建容器,这可能需要一些时间。随后的加载应该会更快。

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

  5. 过了一段时间(所有JavaScript和Clojure依赖项完全下载后),用您的网络浏览器打开localhost:3000。

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

阅读有关其他Metabase版本的文档。

想改进这些文档? 提出更改。