如何在npm全局安装时覆盖依赖版本？解决mermaid-filter安装失败问题

方案一：全局安装时强制替换puppeteer版本 #

利用npm 8.3+支持的--override参数，强制让mermaid-filter使用指定的、能正常下载Chromium的puppeteer版本：

1. 先确定一个兼容mermaid-filter且能正常安装的puppeteer版本（比如19.11.1，可根据实际测试调整）
2. 执行全局安装命令，附带override参数：

npm install -g mermaid-filter --override puppeteer@19.11.1

这个命令会强制npm用指定的puppeteer版本替换mermaid-filter依赖的旧版本，避免下载失效的Chromium安装包。

方案二：本地安装+配置系统路径 #

如果不想修改全局依赖，可通过本地安装后将mermaid-filter加入系统PATH，让pandoc能正常调用：

1. 在任意目录初始化npm项目（比如你的工作文档目录）：

npm init -y

2. 在项目的package.json中添加依赖覆盖规则，确保安装指定版本的puppeteer：

"overrides": {
  "mermaid-filter": {
    "puppeteer": "19.11.1"
  }
}

3. 安装本地依赖：

npm install mermaid-filter

4. 找到mermaid-filter的可执行文件路径：项目目录/node_modules/.bin/mermaid-filter
5. 将该路径添加到系统环境变量PATH中：
   • Windows：打开「系统属性-环境变量」，编辑用户或系统的PATH，添加上述路径
   • Linux/macOS：在~/.bashrc或~/.zshrc中添加：

     export PATH="$PATH:/你的项目绝对路径/node_modules/.bin"
     

     执行source ~/.bashrc（或对应shell配置文件）生效
6. 测试：运行pandoc --filter mermaid-filter，无报错则配置成功

额外提示 #

如果指定新版本puppeteer后mermaid-filter运行报错，说明版本兼容性有问题：

• 查看mermaid-filter的package.json中puppeteer的依赖范围（比如^10.0.0），选择该范围内最后一个能正常下载Chromium的版本
• 或尝试fork mermaid-filter仓库，更新其puppeteer依赖后自行打包安装

内容的提问来源于stack exchange，提问作者BillRobertson42