npm(Node Package Manager)是Node.js的包管理器,它提供了一系列强大的命令用于安装、管理、共享和发布Node.js的软件包。以下是一些常用的npm命令详解:
1. 初始化项目
npm init
该命令会引导你创建一个package.json
文件,它是项目的配置文件,包含项目的基本信息如名称、版本、作者等。运行时,会提示你填写相关信息。
2. 安装包
全局安装
npm install -g <package-name>
全局安装一个包,例如安装create-react-app
:
npm install -g create-react-app
本地安装
npm install <package-name>
在当前项目下安装依赖包,并将信息写入package.json
的dependencies
部分,例如安装express
:
npm install express
保存到dependencies(默认行为)
npm install <package-name> --save
或简写为:
npm i <package-name> -S
保存到devDependencies
npm install <package-name> --save-dev
或简写为:
npm i <package-name> -D
3. 卸载包
全局卸载
npm uninstall -g <package-name>
本地卸载并从package.json中移除
npm uninstall <package-name>
4. 更新包
更新全局包
npm update -g <package-name>
更新本地包并保持与package.json同步
npm update <package-name>
或更新所有本地包至最新兼容版本:
npm update
5. 查看已安装的包
查看全局安装的包
npm list -g --depth=0
查看当前项目的所有依赖
npm list
或查看指定包的详细信息:
npm view <package-name>
6. 清理缓存
npm cache clean --force
在新版npm(v5及以上)中,自动维护缓存,一般无需手动清理。
7. 发布包
npm login
npm publish
登录npm账号后,发布当前项目到npm仓库。
8. 查看npm版本
npm -v
查看npm客户端本身的版本。
9. 查看包的版本
npm view <package-name> version
查看指定包的最新版本。
10. 设置npm镜像源
npm config set registry <registry-url>
例如设置为淘宝npm镜像:
npm config set registry https://registry.npm.taobao.org
11. 检查npm配置
npm config list
列出所有配置项及其值。
12. 安装特定版本的包
npm install <package-name>@<version>
例如安装特定版本的lodash
:
npm install lodash@4.17.21
13. 使用package-lock.json
npm install
在项目中,npm install
会根据package-lock.json
锁定依赖包的具体版本,保证项目在不同环境下的依赖一致性。
当然,以下是更多的npm命令及其详细说明和示例:
14. 安装特定范围的版本
npm install <package-name>@">=1.0.0 <2.0.0"
安装满足指定版本范围的包。例如,安装react
版本在1.0.0及以上但小于2.0.0的版本。
15. 查看依赖树
npm ls
显示当前项目的依赖树,可以看到所有依赖包及其版本,以及它们的依赖关系。
16. 执行npm脚本
npm run <script-name>
执行package.json
中scripts字段定义的脚本。例如,执行start
脚本:
npm run start
17. 安装项目所有依赖(包括devDependencies)
npm install
在项目根目录下运行此命令,npm将根据package.json
文件安装所有依赖(包括dependencies
和devDependencies
)。
18. 安装项目生产环境依赖
npm ci
使用npm ci
命令可以根据package-lock.json
或npm-shrinkwrap.json
文件快速安装项目生产环境依赖。此命令比npm install
更快,因为它不会试图解决任何版本冲突,而是直接安装指定版本的依赖。
19. 检查过时的包
npm outdated
检查项目中哪些依赖包存在更新版本,列出可以升级的包及其当前版本和最新版本。
20. 安装peerDependencies
npm install --peer
从peerDependencies
中安装必要的包,这在安装依赖了某个库的插件时特别有用,因为插件可能要求宿主库的特定版本。
21. 显示npm帮助文档
npm help
显示npm的帮助文档,或者指定一个命令查看该命令的帮助信息:
npm help install
具体开发中如果不太清楚的话,可以通过npm help
命令查阅更多详细信息。