使用 Visual Studio Code 进行开发
调试
首先,安装以下扩展
注意:Debugger for Chrome 已弃用。您可以安全地删除它,因为 Visual Studio Code 现在拥有 内置的 JavaScript Debugger,它提供了相同的功能。
在开始调试会话之前,请确保 Metabase 已构建并正在运行。选择菜单视图、命令面板,搜索并选择Tasks: Run Build Task。或者,使用对应的快捷键 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
- 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 仓库
-
从视图菜单中,选择命令面板…,然后找到Remote-Container: Reopen in Container。(VS Code 也可能通过“在容器中打开”弹出窗口提示您这样做)。注意:VS Code 将首次创建容器,这可能需要一些时间。后续加载应该会快得多。
-
使用视图菜单,命令面板,搜索并选择Tasks: Run Build Task(或者,使用快捷键
Ctrl+Shift+B)。 -
稍等片刻(在所有 JavaScript 和 Clojure 依赖项完全下载后),用您的网络浏览器打开 localhost:3000。
有关使用 Docker 运行 Metabase 开发分支的更多信息,请参见此处。
阅读其他版本的 Metabase 的文档。