npm 安装与使用

晴雨日记

于 2025-06-07 13:11:32 发布

阅读量716

点赞数 19

CC 4.0 BY-SA版权

分类专栏：安装日记文章标签： npm 前端 node.js

本文链接：https://blog.csdn.net/weixin_43510208/article/details/148493951

安装日记专栏收录该内容

14 篇文章

订阅专栏

npm 安装与使用指南

1. 安装 npm

npm 是 Node.js 的包管理器，通常随 Node.js 一起安装：

步骤：
1. 访问 Node.js 官网
2. 下载 LTS 版本（推荐稳定版）
3. 运行安装程序（默认包含 npm）

验证安装：

node -v  # 检查 Node.js 版本
npm -v   # 检查 npm 版本

2. 基础命令

命令	说明
`npm init`	初始化项目（生成 `package.json`）
`npm init -y`	快速初始化（跳过提问）
`npm install <包名>`	安装包（局部）
`npm i -g <包名>`	全局安装（如 `npm i -g typescript`）
`npm uninstall <包名>`	卸载包
`npm update <包名>`	更新包
`npm list`	查看已安装的包
`npm run <脚本名>`	运行 `package.json` 中的脚本

3. 核心操作详解

1. 安装依赖

npm install express         # 安装最新版
npm install express@4.18.2  # 安装指定版本
npm i axios lodash          # 安装多个包

2. 安装类型：

局部安装（默认）：安装到 node_modules/
```
npm install <包名>
```
全局安装（工具类包，如 ts-node）：
```
npm install -g <包名>
```

3. 依赖类型：

npm install --save         # 写入 dependencies（运行时依赖）
npm install --save-dev     # 写入 devDependencies（开发依赖）
# 简写：
npm i -S <包名>           # --save 简写
npm i -D <包名>           # --save-dev 简写

4. 批量安装：

npm install   # 根据 package.json 安装所有依赖
npm ci        # 严格依赖锁定（用于 CI/CD，需存在 package-lock.json）

4. 配置文件 `package.json`

关键字段：

{
  "name": "项目名",
  "version": "1.0.0",
  "scripts": {
    "start": "node app.js",       // 运行 npm run start
    "build": "tsc"
  },
  "dependencies": {              // 生产依赖
    "express": "^4.18.2"
  },
  "devDependencies": {           // 开发依赖
    "typescript": "^5.0.0"
  }
}

5. 镜像加速（解决下载慢）

临时使用淘宝镜像：

npm install <包名> --registry=https://registry.npmmirror.com

永久切换镜像：

npm config set registry https://registry.npmmirror.com

恢复官方源：

npm config set registry https://registry.npmjs.org

6. 常见问题解决

权限错误（全局安装时）：

# Linux/macOS：
sudo npm install -g <包名>

# 或修正 npm 目录权限：
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'

清理缓存：
```
npm cache clean --force
```

修复依赖冲突：

rm -rf node_modules package-lock.json
npm install

7. 高级技巧

查看包信息：

npm view <包名> version    # 查看最新版本
npm info <包名>            # 查看包详情

运行本地命令：

npx <命令>   # 例：npx create-react-app my-app

发布包：

npm login     # 登录 npm 账号
npm publish   # 发布包（需先配置 package.json）

官方文档：npm Docs
中文镜像站：npmmirror 镜像站