npm 从入门到精通（一）：先会用，30 分钟掌握 npm 最常用命令npm 系列文章总规划《npm 从入门到精通》系

npm 系列文章总规划

《npm 从入门到精通》系列

系列目录

npm 从入门到精通（一）：先会用，30 分钟掌握 npm 最常用命令
npm 从入门到精通（二）：再理解，彻底搞懂 package.json、node_modules 和 package-lock
npm 从入门到精通（三）：再进阶，掌握版本管理、脚本系统与包发布
npm 从入门到精通（四）：再工程化，面向团队协作的 npm 最佳实践

第一篇：npm 从入门到精通（一）：先会用，30 分钟掌握 npm 最常用命令

很多人第一次接触 npm，都是从 npm install 开始的。
但如果只是会复制命令，很容易停留在“能跑就行”的阶段。学习 npm 最好的方式，不是上来就啃所有概念，而是先把最常用的操作跑通。先会用，再理解，效率最高。

这篇文章不讲太多抽象概念，重点是：让你用最短时间把 npm 用起来。

一、npm 是什么

npm 是 Node.js 默认的包管理工具。

它主要做三件事：

安装依赖包
管理项目依赖
运行项目脚本

一句话理解：

npm 是 JavaScript / Node 项目里最常用的“装包 + 跑命令”工具。

二、先确认环境是否安装成功

npm 一般会随着 Node.js 一起安装。

在终端执行：

node -v
npm -v

如果能看到版本号，说明环境可用。

例如：

v22.3.0
10.9.0

如果提示命令不存在，先去安装 Node.js。

三、创建第一个 npm 项目

1. 新建目录

mkdir my-npm-demo
cd my-npm-demo

2. 初始化项目

npm init -y

执行后会生成一个 package.json 文件。

这个文件先不用怕，当前你只要知道：

它是 npm 项目的核心配置文件。

四、安装第一个依赖

比如安装一个常用工具包 lodash：

npm install lodash

也可以简写成：

npm i lodash

安装完成后，你会看到项目目录多出两个东西：

node_modules
package-lock.json

并且 package.json 中会出现：

"dependencies": {
  "lodash": "^4.17.21"
}

这说明依赖已经被成功记录。

五、安装开发依赖

很多包只在开发时使用，比如构建工具、测试工具、代码检查工具。

这类包一般这样安装：

npm install vite -D

或：

npm i vite --save-dev

它会写入：

"devDependencies": {
  "vite": "^7.0.0"
}

这里先记住一个简单原则：

运行项目要用的包：放 dependencies
开发时才用的包：放 devDependencies

六、卸载依赖

如果某个包不用了，可以删除：

npm uninstall lodash

npm 会同时：

删除 node_modules 中的包
删除 package.json 中的依赖记录

七、运行 npm 脚本

这是 npm 日常使用里非常重要的一部分。

先在 package.json 中写入：

{
  "name": "my-npm-demo",
  "version": "1.0.0",
  "scripts": {
    "dev": "echo hello npm",
    "build": "echo build project"
  }
}

然后执行：

npm run dev
npm run build

你会发现 npm 不只是装包工具，它还是一个项目命令执行入口。

这也是为什么在 Vue、React、Vite、Next.js 项目里你经常看到：

npm run dev
npm run build
npm run test

八、最常用命令速查

下面这组命令，足够你完成大多数基础操作：

npm init -y
npm install
npm i lodash
npm i vite -D
npm uninstall lodash
npm run dev
npm run build
npm list --depth=0

含义对应如下：

命令	作用
`npm init -y`	快速初始化项目
`npm install`	安装当前项目所有依赖
`npm i 包名`	安装某个依赖
`npm i 包名 -D`	安装开发依赖
`npm uninstall 包名`	删除依赖
`npm run xxx`	运行脚本
`npm list --depth=0`	查看顶层依赖

九、一个完整小练习

你可以自己跑一遍这个流程：

1. 初始化项目

mkdir npm-demo
cd npm-demo
npm init -y

2. 安装依赖

npm i lodash
npm i vite -D

3. 查看依赖

npm list --depth=0

4. 修改 `package.json`

{
  "name": "npm-demo",
  "version": "1.0.0",
  "scripts": {
    "dev": "echo dev running",
    "build": "echo build running"
  },
  "dependencies": {
    "lodash": "^4.17.21"
  },
  "devDependencies": {
    "vite": "^7.0.0"
  }
}

5. 执行脚本

npm run dev
npm run build

做到这里，你已经完成了 npm 的第一轮入门。

十、初学者最常见问题

1. `node_modules` 是什么？

它是依赖真正安装下来的目录。

2. `package.json` 是什么？

它是项目的配置文件，记录依赖和脚本。

3. `package-lock.json` 是什么？

它记录“实际安装的精确版本”。

4. 为什么有时候别人项目拉下来先执行 `npm install`？

因为要先把依赖装下来，项目才能运行。

总结

这篇文章的目标不是让你“懂透 npm”，而是让你先会用。
只要你已经掌握下面这些动作，就算成功入门了：

初始化项目
安装依赖
安装开发依赖
卸载依赖
运行脚本

下一篇我们会进入第二层：
为什么 npm 要有 package.json、node_modules、package-lock.json？它们之间到底是什么关系？

npm 从入门到精通（一）：先会用，30 分钟掌握 npm 最常用命令