我们将一步步介绍如何安装 Mermaid CLI(命令行工具),也就是 mmdc,这是一个非常强大的工具,允许你通过命令行将 Mermaid 图表转换成图片格式。
Mermaid 是一种用于生成图表和流程图的标记语言,非常适合文档和技术博客。下面的步骤将指导你完成整个安装过程,包括如何解决安装过程中可能遇到的一些常见问题。
1. 安装 NVM 和 Node.js
首先,我们需要安装 Node Version Manager(NVM),这是一个可以让你轻松切换 Node.js 版本的工具。这对于开发环境来说非常方便。
Linux 安装 NVM:
打开终端并执行以下命令安装 NVM:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
安装完成后,关闭并重新打开终端,然后检查 NVM 是否正确安装:
nvm --version
安装 Node.js:
接下来,使用 NVM 安装 Node.js。这里,我们选择安装版本 18.16.0,因为它是在撰写本文时的稳定版本之一:
nvm install 18.16.0
nvm use 18.16.0
验证 Node.js 和 npm 的安装:
node -v
npm -v
2. 安装 Mermaid CLI
现在,我们来安装 Mermaid CLI。由于直接使用 npm 可能会遇到网络问题,我们推荐使用淘宝的 npm 镜像。
使用淘宝镜像安装 Mermaid CLI:
npm install -g @mermaid-js/mermaid-cli --registry=https://registry.npm.taobao.org
如果你遇到了与 Puppeteer 相关的安装问题,比如下载 Chrome 失败,你可以通过以下步骤解决:
#设置代理(如果你处于需要代理的网络环境中):
npm config set proxy http://127.0.0.1:8888
npm config set https-proxy http://127.0.0.1:8888
#手动下载 Chrome:
#如果 Puppeteer 下载 Chrome 失败,手动下载 Chrome 压缩包,并放置到 ~/.cache/puppeteer/ 目录下,
#再重新运行安装命令:
npm install -g @mermaid-js/mermaid-cli
3. 解决常见的安装问题
CERT_HAS_EXPIRED 错误:
如果你遇到 CERT_HAS_EXPIRED 错误,可以尝试以下命令解决:
npm cache clean --force
npm config set strict-ssl false
Puppeteer 错误:
如果在安装过程中遇到 Puppeteer 相关的错误,确保你没有跳过代理设置(如果你在需要代理的网络中)。
你也可以设置环境变量跳过 Puppeteer 的下载,不建议跳过,跳过之后需要手动安装PUPPETEER和Chrome,建议使用代理方式安装。
export PUPPETEER_SKIP_DOWNLOAD=true
以上就是 Mermaid CLI(mmdc)的安装步骤和解决安装过程中可能遇到的问题的方法。希望这篇指南能帮助你顺利完成安装,享受 Mermaid 带来的便利!