You need to enable JavaScript to run this app. Angular库生产构建@types/html2canvas需经allowedNonPeerDependencies显式允许的解决方法
优惠活动
大模型
产品
解决方案
定价
更多

Angular库生产构建@types/html2canvas需经allowedNonPeerDependencies显式允许的解决方法

Angular库项目生产构建@types/html2canvas相关报错解决方案

报错触发逻辑

Angular 12及以上版本集成的ng-packagr构建工具,在执行生产编译时会做依赖校验:所有不属于库peerDependencies范畴的第三方依赖,必须通过显式配置允许参与构建,否则会直接终止流程并抛出must be explicitly allowed using the "allowedNonPeerDependencies" option提示。

解决步骤

  1. 找到库项目根目录下的ng-package.json文件,该文件和项目的package.json处于同一层级。
  2. 在配置的顶层节点新增allowedNonPeerDependencies数组配置,将@types/html2canvas加入数组,参考配置结构:

    配置参考示例

    {
      "$schema": "./node_modules/ng-packagr/ng-package.schema.json",
      "dest": "./dist/你的库名",
      "lib": {
        "entryFile": "src/public-api.ts"
      },
      "allowedNonPeerDependencies": [
        "@types/html2canvas"
      ]
    }
    
  3. 补充校验:如果库代码中直接引入调用了html2canvas的运行时方法,而非仅靠类型定义做开发,需要把html2canvas本体也加入上述数组,否则类型依赖放行后,构建会继续抛出关于html2canvas本体的同类拦截报错。

配置注意点

  • 不要把allowedNonPeerDependencies错放到lib子配置节点下,该配置属于顶层规则,层级错误会导致配置失效。
  • 不要把@types/html2canvas这类纯类型声明包放到peerDependencies中,这类包无运行时代码,放入peerDependencies会让库的使用者收到不必要的安装提示,增大项目冗余。
  • 修改完成后重新执行ng build --prod即可正常完成生产编译。

内容的提问来源于stack exchange,提问作者Ricardo Rocha

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.30 14:06:03