如何在发布至NPM前测试Angular库？主项目验证方法咨询

一、让Angular识别node_modules中手动替换的库文件 #

如果你坚持手动替换node_modules里的库文件，需要清除Angular的构建缓存才能让变更生效：

• 清理Angular CLI缓存：ng cache clean
• 删除主项目的本地缓存目录：rm -rf node_modules/.cache（Linux/macOS）或rd /s /q node_modules\.cache（Windows）
• 重启开发服务器时禁用缓存：ng serve --no-cache

注意：手动替换文件容易出错，比如哈希文件名不匹配、遗漏依赖文件，不推荐长期使用。

二、规范的预发布测试方法（推荐） #

1. 本地链接（npm/yarn link） #

这是最便捷的实时测试方式：

• 在库项目中构建并监听变更：ng build your-library-name --watch
• 进入库的dist目录，运行npm link（将本地库注册到全局npm）
• 回到主项目，运行npm link your-library-name（将主项目的库依赖指向本地构建产物）
• 此时修改库代码，构建会自动更新，主项目刷新后就能看到效果

2. 本地文件依赖 #

直接在主项目的package.json中指定库的本地路径：

• 构建库后，修改主项目package.json的依赖：

  "dependencies": {
    "your-library-name": "file:../your-library-project/dist/your-library-name"
  }
  

• 运行npm install更新依赖，重启主项目开发服务器即可

3. 本地tar包测试（最接近NPM发布环境） #

模拟真实的NPM安装流程：

• 构建库后，进入dist目录运行npm pack，生成类似your-library-name-1.0.0.tgz的压缩包
• 在主项目中安装这个tar包：npm install ../your-library-project/dist/your-library-name-1.0.0.tgz
• 这种方式完全模拟了从NPM安装的场景，能测试包的完整性和依赖声明是否正确

4. 集成CI预发布验证 #

如果有CI/CD流程，可以添加预发布测试步骤：

• 自动构建库并生成tar包
• 在CI环境中拉取主项目代码，安装本地tar包
• 运行主项目的单元测试、e2e测试，确保库与主项目的其他依赖兼容

注意事项 #

• 始终使用生产环境构建库：ng build your-library-name --configuration production，避免开发构建产物与发布版本差异过大
• 确认库的peerDependencies与主项目的依赖版本匹配，避免版本冲突
• 主项目与库的Angular大版本需保持一致（比如都是16.x），否则会出现兼容性问题

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