npm宿主依赖、宿主环境依赖（peerDependencies）（指由宿主环境提供的依赖）
文章目录
- 宿主环境依赖详解
- 基本概念
- 工作原理
- 应用场景
- 插件开发
- UI组件库
- 与其他依赖类型对比
- npm不同版本处理差异
- npm v3-v6
- npm v7+
- 实际应用示例
- React插件开发
- 解决宿主依赖问题
宿主环境依赖详解
基本概念
宿主环境依赖（peerDependencies）是指包声明自身与哪些包兼容，但这些包应由使用者（宿主环境）提供，而非包自身安装。这种依赖类型主要用于插件、组件库等场景，避免核心包被重复安装导致的冲突问题。
工作原理
宿主环境依赖在package.json中通过peerDependencies字段声明：
{"name": "react-router","peerDependencies": {"react": ">=16.8.0" // 声明需要宿主环境提供React 16.8.0或更高版本}
}
应用场景
插件开发
// eslint-plugin-react的package.json
{"name": "eslint-plugin-react","peerDependencies": {"eslint": "^3.0.0 || ^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0"}
}
UI组件库
// antd组件库的package.json
{"name": "antd","peerDependencies": {"react": ">=16.9.0","react-dom": ">=16.9.0"}
}
与其他依赖类型对比
| 依赖类型 | 安装位置 | 用途 | 被安装方式 |
|---|---|---|---|
| dependencies | 包自身依赖 | 运行时所需 | 自动安装 |
| devDependencies | 开发时依赖 | 开发/构建所需 | 开发时安装 |
| peerDependencies | 宿主环境依赖 | 声明兼容性需求 | 由使用者安装 |
npm不同版本处理差异
npm v3-v6
不会自动安装宿主依赖，但会发出警告：
warning "package-a" has unmet peer dependency "core-package@2.0.0"
npm v7+
默认自动安装宿主依赖，除非特定选项禁用：
# 禁用自动安装宿主依赖
npm install --legacy-peer-deps
实际应用示例
React插件开发
// 某React表单库的package.json
{"name": "react-hook-form","version": "7.34.0","peerDependencies": {"react": "^16.8.0 || ^17 || ^18"},"dependencies": {"use-form-persist": "^1.0.3" // 该库自身的依赖},"devDependencies": {"typescript": "^4.7.4", // 开发时用的工具"jest": "^28.1.3" // 测试工具}
}
解决宿主依赖问题
当遇到宿主依赖兼容性问题时：
# 安装特定版本满足要求
npm install react@17.0.2# npm v7+环境强制使用旧版行为
npm install --legacy-peer-deps# 或忽略宿主依赖冲突
npm install --force
宿主环境依赖是一种确保插件、库与核心框架版本兼容性的重要机制，合理使用可避免版本冲突和重复安装问题，提高代码质量和稳定性。
ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ
ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ ᅟᅠ