指令集-NPM 常用指令速查手册

文章描述: NPM (Node Package Manager) 是前端开发不可或缺的包管理工具。无论是引入第三方库、运行构建脚本,还是管理项目依赖版本,NPM 都扮演着核心角色。本文整理了 NPM 最常用的指令集,涵盖项目初始化、依赖管理、脚本执行、镜像源配置等高频场景。每条指令均附带实战示例,助你快速解决依赖问题,提升开发效率。


1. 项目初始化

生成配置文件

bash 复制代码
# 交互式创建 package.json
npm init
# 快速生成默认配置(跳过提问)
npm init -y

2. 依赖安装

基础安装

bash 复制代码
# 根据 package.json 安装所有依赖
npm install
# 简写
npm i
# 安装指定包(生产环境依赖)
npm install lodash
npm i lodash
# 安装指定版本
npm i vue@2.6.14

分类安装

bash 复制代码
# 安装开发环境依赖
npm install webpack --save-dev
# 简写
npm i webpack -D
# 安装生产环境依赖(默认行为)
npm i axios -S
# 全局安装(通常用于脚手架工具)
npm i -g typescript
npm i -g yarn

3. 依赖卸载与更新

卸载依赖

bash 复制代码
# 卸载项目依赖
npm uninstall lodash
# 卸载全局依赖
npm uninstall -g typescript

更新依赖

bash 复制代码
# 检查过时的包
npm outdated
# 更新指定包
npm update lodash
# 更新所有包(受 package.json 版本规则限制)
npm update

4. 脚本执行

运行脚本

bash 复制代码
# 运行 package.json 中的 scripts
npm run dev
npm run build
npm run serve
# 运行特殊脚本(可省略 run)
npm start
npm test

查看脚本列表

bash 复制代码
# 查看当前项目所有可用脚本
npm run

5. 查看与管理

查看信息

bash 复制代码
# 查看包的最新版本号
npm view vue version
# 查看包的所有历史版本
npm view vue versions
# 查看包的详细信息
npm view vue
# 查看全局安装路径
npm root -g
# 查看当前项目安装了哪些包
npm list --depth=0

检查与修复

bash 复制代码
# 扫描项目漏洞
npm audit
# 自动修复漏洞
npm audit fix

6. 镜像源管理

切换镜像源(解决下载慢)

bash 复制代码
# 查看当前镜像源
npm config get registry
# 临时指定镜像源安装
npm i lodash --registry=https://registry.npmmirror.com
# 永久切换为淘宝镜像
npm config set registry https://registry.npmmirror.com
# 切换回官方镜像
npm config set registry https://registry.npmjs.org/

清理缓存

bash 复制代码
# 强制清理 npm 缓存(解决安装报错)
npm cache clean --force

7. 版本号说明

语义化版本控制

复制代码
例如:1.2.3
主版本号.次版本号.修订号
^1.2.3:锁定主版本,允许次版本和修订号升级(最常用)
~1.2.3:锁定主版本和次版本,只允许修订号升级
1.2.3:精确安装指定版本,不升级

8. 常见故障排查流程

  1. 删依赖重装 :

    bash 复制代码
    # 删除 node_modules 和 lock 文件重新安装
    rm -rf node_modules package-lock.json
    npm i
  2. 清缓存 :

    bash 复制代码
    npm cache clean --force
  3. 查源 :

    bash 复制代码
    # 如果下载失败,检查是否切回了官方源,建议切回淘宝源
    npm config set registry https://registry.npmmirror.com
相关推荐
特创数字科技6 分钟前
纯本地离线运行的文档脱敏工具(技术分享)
前端·驱动开发·python
心之语歌20 分钟前
uni-app uts原生插件开发:uts 与 Kotlin 交互踩坑实录(附解决方案)
前端·后端
再吃一根胡萝卜40 分钟前
DSH 插件数据链路:Host 管数据,Client 只管画
前端
feixing_fx1 小时前
CSS 变量(Custom Properties):构建可扩展的主题切换系统
前端·css·前端框架·html·css3
十有八七2 小时前
手搓 Agent(一):先有大脑——大模型只会做一件事
前端·人工智能·后端
锋行天下2 小时前
「踩坑实录」给 LangGraph Agent 接两个 FastMCP,我被 langchain 偷偷改了工具名
前端·人工智能·后端
跳跳的小星星2 小时前
自研组件】Vue2 + ElementUI 通用列表页封装 wkjp-list-page,一套配置搞定搜索、动态表格、分页、增删改
前端
tryCbest3 小时前
Vue3—— 第 18 篇:Vue 2 到 Vue 3 迁移指南——升级避坑全记录
前端·vue.js
保利威视频SaaS小张3 小时前
企业直播接入笔记 12|企业内训直播怎么做签到和学时统计,防挂机这件事比想象中难
java·前端·数据库·笔记·视频云·polvy·polyv
bysking3 小时前
GitHub Actions 快速入门+场景实践案例
前端·后端·github