-D 是 npm install 命令的常用选项,它的完整形式是 --save-dev,意思是:
主要作用
将包作为开发依赖(devDependencies)保存到 package.json 中
具体解释:
1. 依赖分类
json
{
"dependencies": {
"express": "^4.18.0" // 生产依赖
},
"devDependencies": {
"typescript": "^5.0.0", // 开发依赖
"jest": "^29.0.0" // 开发依赖
}
}
2. 区分开发依赖和生产依赖
-
生产依赖(dependencies):项目运行时必需的包
- 如:express, react, lodash
- 安装:
npm install express
-
开发依赖(devDependencies):只在开发阶段需要的包
- 如:测试框架、构建工具、代码检查工具
- 安装:
npm install -D typescript
3. 实际应用场景
bash
# 安装生产依赖
npm install express
# 安装开发依赖
npm install -D typescript
npm install -D jest
npm install -D webpack
# 或者完整写法
npm install --save-dev typescript
4. 重要影响
- 部署影响 :使用
npm install --production或设置NODE_ENV=production时,只安装生产依赖 - 项目共享 :别人克隆你的项目后,运行
npm install会安装所有依赖(包括开发依赖)
等价命令
bash
npm i -D package-name # 简写
npm install --save-dev package-name # 完整写法
yarn add -D package-name # yarn 的写法
示例对比
bash
# 项目需要 TypeScript 编译,但生产环境不需要 TypeScript 本身
npm install -D typescript
# 项目需要 Express 来运行服务器
npm install express
简单记法:"-D" = "开发(Development)需要,生产不需要"