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

npm 系列文章总规划《npm 从入门到精通》系列系列目录npm 从入门到精通一先会用30 分钟掌握 npm 最常用命令npm 从入门到精通二再理解彻底搞懂 package.json、node_modules 和 package-locknpm 从入门到精通三再进阶掌握版本管理、脚本系统与包发布npm 从入门到精通四再工程化面向团队协作的 npm 最佳实践第一篇npm 从入门到精通一先会用30 分钟掌握 npm 最常用命令很多人第一次接触 npm都是从npm install开始的。但如果只是会复制命令很容易停留在“能跑就行”的阶段。学习 npm 最好的方式不是上来就啃所有概念而是先把最常用的操作跑通。先会用再理解效率最高。这篇文章不讲太多抽象概念重点是让你用最短时间把 npm 用起来。一、npm 是什么npm 是 Node.js 默认的包管理工具。它主要做三件事安装依赖包管理项目依赖运行项目脚本一句话理解npm 是 JavaScript / Node 项目里最常用的“装包 跑命令”工具。二、先确认环境是否安装成功npm 一般会随着 Node.js 一起安装。在终端执行node-vnpm-v如果能看到版本号说明环境可用。例如v22.3.010.9.0如果提示命令不存在先去安装 Node.js。三、创建第一个 npm 项目1. 新建目录mkdirmy-npm-democdmy-npm-demo2. 初始化项目npminit-y执行后会生成一个package.json文件。这个文件先不用怕当前你只要知道它是 npm 项目的核心配置文件。四、安装第一个依赖比如安装一个常用工具包lodashnpminstalllodash也可以简写成npmi lodash安装完成后你会看到项目目录多出两个东西node_modulespackage-lock.json并且package.json中会出现dependencies:{lodash:^4.17.21}这说明依赖已经被成功记录。五、安装开发依赖很多包只在开发时使用比如构建工具、测试工具、代码检查工具。这类包一般这样安装npminstallvite-D或npmi vite --save-dev它会写入devDependencies:{vite:^7.0.0}这里先记住一个简单原则运行项目要用的包放dependencies开发时才用的包放devDependencies六、卸载依赖如果某个包不用了可以删除npmuninstall lodashnpm 会同时删除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}}然后执行npmrun devnpmrun build你会发现 npm 不只是装包工具它还是一个项目命令执行入口。这也是为什么在 Vue、React、Vite、Next.js 项目里你经常看到npmrun devnpmrun buildnpmruntest八、最常用命令速查下面这组命令足够你完成大多数基础操作npminit-ynpminstallnpmi lodashnpmi vite-Dnpmuninstall lodashnpmrun devnpmrun buildnpmlist--depth0含义对应如下命令作用npm init -y快速初始化项目npm install安装当前项目所有依赖npm i 包名安装某个依赖npm i 包名 -D安装开发依赖npm uninstall 包名删除依赖npm run xxx运行脚本npm list --depth0查看顶层依赖九、一个完整小练习你可以自己跑一遍这个流程1. 初始化项目mkdirnpm-democdnpm-demonpminit-y2. 安装依赖npmi lodashnpmi vite-D3. 查看依赖npmlist--depth04. 修改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. 执行脚本npmrun devnpmrun build做到这里你已经完成了 npm 的第一轮入门。十、初学者最常见问题1.node_modules是什么它是依赖真正安装下来的目录。2.package.json是什么它是项目的配置文件记录依赖和脚本。3.package-lock.json是什么它记录“实际安装的精确版本”。4. 为什么有时候别人项目拉下来先执行npm install因为要先把依赖装下来项目才能运行。总结这篇文章的目标不是让你“懂透 npm”而是让你先会用。只要你已经掌握下面这些动作就算成功入门了初始化项目安装依赖安装开发依赖卸载依赖运行脚本下一篇我们会进入第二层为什么 npm 要有package.json、node_modules、package-lock.json它们之间到底是什么关系