1. 包管理器到底在管理什么
很多人一开始会把 npm 当成“下载库的工具”，这不算错，但不完整。
前端项目里，包管理器实际管理的是三件事：
你平时写的这些命令：
npm install
npm uninstall
npm view
背后都在围绕这三件事工作。
2. 先统一几个概念
2.1 什么是包
包（package）不是“某个单独 js 文件”，而是一个可安装、可复用、可发布的代码单元。一个目录只要有 package.json，通常就可以被当作一个包。
2.2 什么是 npm
npm 这个词在实际语境里经常混用，建议拆开记：
平时命令行里用的 npm xxx，说的是 npm CLI。
2.3 什么是 CLI
CLI 就是命令行接口。比如 npm install、vite build、eslint . 都属于 CLI 命令。
3. 初始化项目：
最基础写法：
npm init
npm init -y
含义：
- npm init：交互式填写并生成 package.json
- npm init -y：全部走默认值
现代 npm 里还有这类写法：
npm init vite@latest
这已经不是单纯生成空配置，而是调用脚手架初始化器。
4. package.json：
{
"name": "my-project",
"version": "1.0.0",
"private": true,
"scripts": {
"dev": "vite",
"build": "vite build"
},
"dependencies": {
"vue": "^3.5.0"
},
"devDependencies": {
"vite": "^7.0.0"
}
}
4.1 dependencies vs devDependencies
- dependencies：运行时需要
- devDependencies：开发/构建阶段需要
常见误区：把所有包都塞进 dependencies，导致生产环境体积膨胀。
4.2 版本前缀怎么理解
- 1.2.3：固定版本
- ^1.2.3：通常允许次版本和补丁升级
- ~1.2.3：通常只允许补丁升级
团队里如果追求稳定可复现，重点不在“全都锁死”，而在锁文件策略。
5. package-lock.json 才是团队一致性的关键
一句话：
- package.json 管“范围”
- package-lock.json 管“这次实际装的精确版本”
所以：
npm ci
6. 安装命令：只记最常用那几条
6.1 本地安装
npm install 包名
npm install 包名@版本号
npm i 包名
6.2 开发依赖
npm install -D 包名
6.3 精确版本
npm install -E 包名
6.4 生产依赖安装
旧写法：
npm install –production
新版更推荐：
npm install –omit=dev
7. 卸载和查看信息
7.1 卸载
npm uninstall 包名
npm rm 包名
npm uninstall -g 包名
默认会同步更新 package.json 和 package-lock.json。
7.2 查看包信息
npm view react versions
npm view react version
npm view vite dist-tags.latest
8. 配置源：哪些写法过时了
查看当前源：
npm config get registry
官方源：
npm config set registry https://registry.npmjs.org/
国内常见镜像：
npm config set registry https://registry.npmmirror.com
9. 实战中常用但新手常漏的 3 个点
9.1 private: true
内部项目建议默认加上：
{
"private": true
}
防止误发布到公共仓库。
9.2 npx 优先于全局安装
很多工具不必全局安装，直接：
npx 包名
更干净，不污染全局环境。
9.3 overrides 处理依赖树问题
统一某个传递依赖版本时很有用：
{
"overrides": {
"lodash": "4.17.21"
}
}
10. 总结
包管理器不是“背命令”，而是“管理依赖生命周期和可复现交付”。
如果你是前端工程化初学者，建议先形成这个最小闭环：
参考文档：
- https://docs.npmjs.com/about-npm
- https://docs.npmjs.com/cli/v11/configuring-npm/package-json
- https://docs.npmjs.com/cli/v11/commands/npm-install
- https://docs.npmjs.com/cli/v11/commands/npm-uninstall
- https://docs.npmjs.com/cli/v11/commands/npm-view
- https://docs.npmjs.com/cli/v11/commands/npm-init
版权声明：本文为学习整理稿，欢迎交流，转载请注明出处。
