npm 包管理

精选 npm 包管理 常用指令与核心速查备忘单，涵盖高频用法、配置参数与实用技巧。 精选 npm 常用指令与核心速查备忘单，涵盖高频用法、配置参数与实用技巧。涵盖安装、更新与管理 Node 包的重要概念与命令。

Star 项目
关注 X (Twitter)
赞赏饮咖啡

#🚀 入门指引

#简介

npm（Node 包管理器）是 Node.js 的默认包管理器。它用于为 Node.js 应用安装、更新和管理包（库或模块）。

#安装与检查版本

从 nodejs.org 安装 Node.js，其中包含 npm。安装后，您可以使用以下命令检查已安装的 npm 版本：

npm --version
# 或
npm -v

#初始化新项目

npm init # 交互式初始化
# 或
npm init -y # 使用默认值创建 package.json

#安装包

#从 package.json 安装依赖

npm install
# 或
npm i

#安装特定包

npm install <package-name>              # 安装并加入 dependencies
npm install <package-name> --save-dev   # 加入 devDependencies
npm install <package-name> -D           # --save-dev 的简写
npm install <package-name> -g           # 全局安装
npm install <package-name>@<version>    # 安装指定版本
npm install <package-name>@latest       # 安装最新版本

#卸载包

npm uninstall <package-name>          # 卸载包
npm uninstall <package-name> -g       # 全局卸载
npm rm <package-name>                 # uninstall 的简写

#查看、搜索与探索包

#查看包

npm view <package-name>               # 查看包详情
npm view <package-name> versions      # 查看包的所有版本
npm view <package-name> version       # 查看包的最新版本
npm view <package-name> description   # 查看包的描述

#搜索包

npm search <search-term>              # 按关键词搜索相关包

#探索包

npm docs <package-name>                # 在浏览器中打开包文档
npm home <package-name>                # 在浏览器中打开包主页
npm repo <package-name>                # 在浏览器中打开包仓库

#管理包

#更新包

npm outdated                           # 检查过时的包
npm update <package-name>              # 更新指定包
npm update                             # 更新全部包

#列出已安装的包

npm list                              # 列出当前项目已安装的包
npm list -g                           # 列出全局已安装的包
npm list --depth=0                    # 仅列出顶层已安装的包

#运行脚本

npm run <script-name>                 # 运行 package.json 中定义的脚本
npm start                             # 运行 start 脚本
npm test                              # 运行 test 脚本
npm build                             # 运行 build 脚本

#缓存管理

npm cache verify                      # 校验 npm 缓存完整性
npm cache clean                       # 清理 npm 缓存
npm cache clean --强制执行               # 强制清理 npm 缓存

#配置 npm

npm config list                       # 列出全部 npm 配置
npm config set <key> <value>          # 设置配置项
npm config get <key>                  # 读取配置项的值
npm config delete <key>               # 删除配置项

#审计与安全

npm audit                             # 审计依赖漏洞
npm audit fix                         # 修复依赖漏洞
npm audit fix --强制执行                 # 强制修复，可能升级主版本

#发布包

npm login                             # 登录 npm 账号 (npmjs.com)
npm publish                           # 将包发布到 npm 仓库
npm version <new-version>             # 提升包版本 (如 patch、minor、major)
npm unpublish <package-name>          # 撤销发布（发布后 72 小时内）

#其他实用命令

npm help                              # 查看 npm 通用帮助
npm help <command>                    # 查看指定命令的帮助
npm ci                                # 按 package-lock.json 干净安装依赖
npm prune                             # 移除多余的包
npm dedupe                           # 减少 node_modules 中的重复依赖