# npm 常用命令速查npm 包管理器常用命令速查手册，涵盖项目初始化、依赖管理、脚本执行等核心操作

## 一、项目初始化与配置

- `npm init`: 交互式创建 package.json，需逐项填写项目信息
- `npm init -y`: 跳过交互，直接用默认值生成 package.json（最常用）
- `npm config list`: 查看当前 npm 配置
- `npm config set registry <url>`: 切换镜像源（如淘宝镜像加速下载）
- `npm get registry`: 查看当前使用的镜像源地址

## 二、依赖安装（最高频）

- `npm install` / `npm i`: 安装 package.json 中声明的所有依赖
- `npm install <包名>`: 安装指定包并写入 dependencies（生产依赖）
- `npm install <包名> --save-dev` / `-D`: 安装为开发依赖（如 webpack、eslint），写入 devDependencies
- `npm install <包名> -g`: 全局安装（用于 CLI 工具，如 nodemon、pm2）
- `npm install <包名>@<版本号>`: 安装指定版本，如 npm install vue@3.4.0
- `npm ci`: 严格按 package-lock.json 安装，速度更快、结果更可复现（CI/CD 环境推荐）

## 三、依赖卸载与更新

- `npm uninstall <包名>` / `npm remove <包名>`: 卸载包并自动从 package.json 移除
- `npm uninstall <包名> -g`: 卸载全局包
- `npm update`: 更新所有依赖到 package.json 允许的最新版本
- `npm update <包名>`: 只更新指定包
- `npm outdated`: 列出当前项目中已过时的包及可升级版本

## 四、脚本执行

- `npm run <脚本名>`: 执行 package.json 中 scripts 字段定义的命令，如 npm run dev、npm run build
- `npm start`: 等价于 npm run start，启动项目的快捷命令
- `npm test`: 等价于 npm run test，运行测试的快捷命令
- `npm run`（不带参数）: 列出当前项目所有可用脚本

## 五、查询与诊断

- `npm list` / `npm ls`: 查看当前项目已安装的依赖树
- `npm list -g --depth=0`: 查看全局安装的包（不展开子依赖）
- `npm info <包名>`: 查看某个包的详细信息（版本、描述、仓库等）
- `npm search <关键词>`: 在 npm 仓库中搜索包
- `npm audit`: 扫描项目依赖的安全漏洞
- `npm audit fix`: 自动修复可修复的安全漏洞
- `npm cache clean --force`: 强制清除本地缓存（解决奇怪的安装问题时用）

## 六、发布相关

- `npm login`: 登录 npm 账号
- `npm publish`: 将当前包发布到 npm 公共仓库
- `npm unpublish <包名>@<版本>`: 撤销已发布的版本（有时间窗口限制）
- `npm version patch/minor/major`: 按语义化版本规则自动递增版本号并打 git tag

## 实用技巧

- **简写记忆**: i = install，un = uninstall，up = update，-D = --save-dev，-g = --global
- **传参给底层脚本**: npm run dev -- --port 3000，双横线 -- 后的内容会透传给实际执行的命令
- **国内加速**: 建议配置淘宝镜像 `npm config set registry https://registry.npmmirror.com`，或使用 cnpm / pnpm 替代
- **锁文件重要性**: 团队协作务必提交 package-lock.json，保证所有人安装的依赖版本一致