发布含外部依赖的Angular库时遇模块未找到问题求助

云原生阿岚

2026-6-24

解决Angular库中axios依赖缺失问题

方案1：将axios声明为Peer Dependency（推荐）

这种方式让消费项目自行安装axios，避免重复打包，符合Angular库的最佳实践：

打开库的package.json，把axios从dependencies移到peerDependencies，指定合适的版本范围：
```
"peerDependencies": {
  "axios": "^1.0.0"
}
```
重新构建库：ng build my-library
用yalc推送或发布后，消费项目执行npm install axios即可解决依赖问题

方案2：强制打包axios到库中

如果必须把axios打包进dist文件，调整Angular构建配置：

打开库的angular.json，找到对应库的build配置，在options里添加allowedCommonJsDependencies配置：

"build": {
  "builder": "@angular-devkit/build-angular:ng-packagr",
  "options": {
    "project": "projects/my-library/package.json",
    "allowedCommonJsDependencies": ["axios"]
  }
}

确保axios仍在库的dependencies中（不要移到peerDependencies）
重新构建库，axios会被打包进fesm文件，消费项目无需额外安装

方案3：用Angular HttpClient替代axios

如果项目允许，直接用Angular自带的HttpClient替换axios，彻底消除外部依赖问题：

修改服务类，注入HttpClient并替换axios调用：

import { HttpClient } from '@angular/common/http';
import { Injectable } from '@angular/core';

@Injectable({ providedIn: 'root' })
export class DataService {
  constructor(private http: HttpClient) {}

  fetchData() {
    return this.http.get('目标API地址');
  }
}