npm install
安装项目依赖包，支持全局安装和指定版本
语法
npm install [<package-spec>] [--save-dev] [--global]
参数
| 参数 | 说明 | 示例 | 级别 |
|---|---|---|---|
(无参数) |
安装 package.json 中所有依赖 | npm install |
常用 |
<package> |
安装指定包到 dependencies | npm install express |
常用 |
-D --save-dev |
安装到 devDependencies | npm install -D jest |
常用 |
-g --global |
全局安装 | npm install -g typescript |
常用 |
@version |
安装指定版本 | npm install react@18.2.0 |
常用 |
--legacy-peer-deps |
忽略 peer 依赖冲突 | npm install --legacy-peer-deps |
进阶 |
示例
安装项目所有依赖
npm install
根据 package.json 和 package-lock.json 安装
安装生产依赖
npm install express mongoose
同时安装多个包
安装开发依赖
npm install -D eslint prettier
只在开发时需要的工具
安装指定版本范围
npm install lodash@^4.17.0
^ 表示兼容版本
常见错误
ERESOLVE unable to resolve dependency tree
依赖版本冲突，尝试 --legacy-peer-deps 或 --force
EACCES permission denied
全局安装权限不足，用 sudo 或配置 npm prefix
npm WARN deprecated
包已废弃，查看替代方案或忽略警告
技巧
- npm ci 比 npm install 更快更严格，适合 CI 环境
- 用 npm install --production 只安装生产依赖
- package-lock.json 应该提交到 git