pnpm切换国内源

i建模2026-04-11 8:49

pnpm切换国内源的操作非常简单，支持临时使用和永久生效两种配置方式，常用主流国内镜像源都可以直接对接，以下是具体操作：

🔍 常用国内镜像源地址

可以先根据自己的网络情况选择其一，推荐优先使用淘宝镜像：

镜像源名称	地址
淘宝npm镜像	`https://registry.npmmirror.com/`
阿里云镜像	`https://mirrors.aliyun.com/npm/`
华为云镜像	`https://repo.huaweicloud.com/repository/npm/`
腾讯云镜像	`https://mirrors.cloud.tencent.com/npm/`

📌 配置方式

1. 临时生效（单条命令）

仅针对当前一次安装操作生效，命令格式为：

bash 复制代码

# 安装依赖时临时指定源
pnpm install --registry=https://registry.npmmirror.com/
# 安装单个包时临时指定源
pnpm add lodash --registry=https://registry.npmmirror.com/

2. 永久生效（全局配置）

配置后所有pnpm操作都会默认使用国内源，命令如下：

bash 复制代码

# 设置自定义镜像源
pnpm config set registry https://registry.npmmirror.com/
# （可选）同时配置二进制包下载源，加速node-sass、canvas等包的安装
pnpm config set disturl https://npmmirror.com/dist/
pnpm config set sass_binary_site https://npmmirror.com/mirrors/node-sass/
pnpm config set electron_mirror https://npmmirror.com/mirrors/electron/

✅ 配置验证与缓存清理

验证配置是否生效：

bash 复制代码

pnpm config get registry

输出你设置的镜像地址即代表配置成功。

配置完成后建议清理旧缓存，避免拉取旧源的资源：

bash 复制代码

pnpm store prune

如果需要切回官方源，执行 pnpm config set registry https://registry.npmjs.org/ 即可。