四时宝库

程序员的知识宝库

Linux上 Mermaid CLI(命令行工具)安装方案

我们将一步步介绍如何安装 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 带来的便利!

发表评论:

控制面板
您好,欢迎到访网站!
  查看权限
网站分类
最新留言
    友情链接