Node.js npm常用命令详解与配置指南

作者:岩茶

时间:2026-10-30

浏览:425

本文系统介绍Node.js中npm的核心命令,涵盖模块安装、版本控制、依赖管理(dependencies与devDependencies)、全局与本地安装、模块卸载与更新、缓存清理及package.json配置。同时详解npm config设置代理与镜像源,解决内网或网络受限环境下的模块安装问题,帮助开发者高效管理项目依赖。

文章目录

npm概述与基础安装

npm是什么

NPM的全称是Node Package Manager,它是随Node.js一同安装的包管理和分发工具,旨在方便JavaScript开发者进行包的下载、安装、上传以及已有包的管理。

npm install 安装模块

基础语法


npm install (with no args, in package dir)
npm install [<@scope>/]<name>
npm install [<@scope>/]<name>@<tag>
npm install [<@scope>/]<name>@<version>
npm install [<@scope>/]<name>@<version range>
npm install <tarball file>
npm install <tarball url>
npm install <folder>
alias: npm i
common options: [-S|--save|-D|--save-dev|-O|--save-optional] [-E|--save-exact] [--dry-run]

安装包时,默认会安装该模块的最新版本。

代码如下:

npm install gulp

npm概述与基础安装

安装指定版本

代码如下:

npm install gulp@3.9.1

依赖管理与package.json配置

安装包并将信息保存到项目的package.json文件中。

npm概述与基础安装

项目对模块的依赖可以使用以下3种方法来表示(假设当前版本号是1.1.0):

兼容模块新发布的补丁版本:~1.1.0、1.1.x、1.1;兼容模块新发布的小版本、补丁版本:^1.1.0、1.x、1;兼容模块新发布的大版本、小版本、补丁版本:*、x。

-S, --save 安装包信息将加入到dependencies(生产阶段的依赖)。

代码如下:

npm install gulp --save 或 npm install gulp -S

package.json 文件的 dependencies 字段:

代码如下:

"dependencies": { "gulp": "^3.9.1"}

-D, --save-dev 安装包信息将加入到devDependencies(开发阶段的依赖),因此开发阶段一般使用它。

代码如下:

npm install gulp --save-dev 或 npm install gulp -D

package.json 文件的 devDependencies字段:

代码如下:

"devDependencies": { "gulp": "^3.9.1"}

-O, --save-optional 安装包信息将加入到optionalDependencies(可选阶段的依赖)。

代码如下:

npm install gulp --save-optional 或 npm install gulp -O

package.json 文件的optionalDependencies字段:

代码如下:

"optionalDependencies": { "gulp": "^3.9.1"},

-E, --save-exact 精确安装指定模块版本。

代码如下:

npm install gulp --save-exact 或 npm install gulp -E

输入命令npm install gulp -ES,留意package.json 文件的 dependencies 字段,可以看到版本号中的^消失了。

代码如下:

"dependencies": { "gulp": "3.9.1"}

模块的依赖都被写入package.json文件后,他人打开项目的根目录(项目开源、内部团队合作),使用npm install命令可以根据dependencies配置安装所有的依赖包。

代码如下:

npm install

npm概述与基础安装

安装范围与模块查看

本地安装(local)。

代码如下:

npm install gulp

全局安装(global),使用-g 或 --global。

代码如下:

npm install gulp -g

npm ls查看安装的模块。

基础语法

代码如下:

npm ls [[<@scope>/]<pkg> ...]aliases: list, la, ll

查看全局安装的模块及依赖。

代码如下:

npm ls -g

模块卸载、更新与检查

npm uninstall卸载模块。

基础语法

代码如下:

npm uninstall [<@scope>/]<pkg>[@<version>]... [-S|--save|-D|--save-dev|-O|--save-optional]aliases: remove, rm, r, un, unlink

如卸载开发版本的模块。

代码如下:

npm uninstall gulp --save-dev

npm update更新模块。

基础语法

代码如下:

npm update [-g] [<pkg>...]

npm outdated检查模块是否已经过时。

基础语法

代码如下:

npm outdated [[<@scope>/]<pkg> ...]

此命令会列出所有已经过时的包,可以及时进行包的更新。

npm概述与基础安装

项目初始化与帮助查询

npm init在项目中引导创建一个package.json文件。

安装包的信息可保持到项目的package.json文件中,以便后续的其它的项目开发或者他人合作使用,这也说明package.json在项目中是必不可少的。

代码如下:

npm init [-f|--force|-y|--yes]

npm概述与基础安装

npm help 查看某条命令的详细帮助。

例如输入npm help install,系统在默认的浏览器或者默认的编辑器中打开本地nodejs安装包的文件/nodejs/node_modules/npm/html/doc/cli/npm-install.html

代码如下:

npm help <command>

路径查看与配置管理

npmroot查看包的安装路径。

输出node_modules的路径。

代码如下:

npm root [-g]

npm config管理npm的配置路径。

基础语法

代码如下:

npm config set <key> <value> [-g|--global]npm config get <key>npm config delete <key>npm config listnpm config editnpm get <key>npm set <key> <value> [-g|--global]

对于config这块用得最多应该是设置代理,解决npm安装一些模块失败的问题。

例如我在公司内网,因为公司的防火墙原因,无法完成任何模块的安装,这个时候设置代理可以解决。

代码如下:

npm config set proxy=http://dev-proxy.oa.com:8080

又如国内的网络环境问题,某官方的IP可能被和谐了,幸好国内有好心人,搭建了镜像,此时我们简单设置镜像。

代码如下:

npm config set registry="http://r.cnpmjs.org"

缓存管理与模块启停

npm cache 管理模块的缓存。

基础语法

代码如下:

npm cache add <tarball file>npm cache add <folder>npm cache add <tarball url>npm cache add <name>@<version>npm cache ls [<path>]npm cache clean [<path>]

最常用命令无非清除npm本地缓存。

代码如下:

npm cache clean

npm start 启动模块。

基础语法

代码如下:

npm start [-- <args>]

该命令写在package.json文件scripts的start字段中,可以自定义命令来配置一个服务器环境和安装一系列的必要程序,如。

代码如下:

"scripts": { "start": "gulp -all"}

如果package.json文件没有设置start,则将直接启动node server.js。

npm stop 停止模块。

基础语法

代码如下:

npm stop [-- <args>]

npm restart 重新启动模块。

基础语法

代码如下:

npm restart [-- <args>]

赶在高考和端午节前的一篇文章,祝高考的同学们超常发挥,也祝大家粽子节快乐,多多陪陪家人。

以上所述是小编给大家介绍的Node.js中npm常用命令大全的相关资料,希望对大家有所帮助!

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章