使用 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 关于在容器内开发的完整指南。
要求
- Visual Studio Code(显然)
- Docker
- VS Code 的 Remote - Containers 扩展
重要: 确保 Docker 正常运行,并且可以用于下载镜像和启动容器,例如通过运行
$ docker run hello-world
如果一切顺利,您应该看到以下消息
Hello from Docker!
This message shows that your installation appears to be working correctly.
步骤
-
克隆 Metabase 仓库
-
启动 VS Code 并打开您克隆的 Metabase 仓库
-
从“视图”(View)菜单中,选择“命令面板…”(Command Palette…),然后找到“远程容器:在容器中重新打开”(Remote-Container: Reopen in Container)。(VS Code 也可能通过“在容器中打开”弹出窗口提示您执行此操作)。注意: VS Code 将首次创建容器,这可能需要一些时间。后续加载应该快得多。
-
使用菜单“视图”(View),“命令面板”(Command Palette),搜索并选择“任务:运行构建任务”(Tasks: Run Build Task)(或者,使用快捷键
Ctrl+Shift+B
)。 -
稍等片刻(待所有 JavaScript 和 Clojure 依赖项完全下载后),用您的网页浏览器打开 localhost:3000。
有关使用 Docker 运行 Metabase 开发分支的更多信息,请参阅此处。
阅读 Metabase 其他版本的文档。