NPM / PNPM / Yarn 加速配置指南（阿里云镜像源）
在国内的开发环境中，默认的 npm / pnpm / yarn 会从国外下载依赖包，往往会出现下载超时或请求失败。为了提升项目加载速度，下面说明如何将这三种主流包管理器的加速域名切换为阿里云加速域 https://registry.npmmirror.com，并验证配置是否生效。
核心目标地址
所有操作均基于以下官方加速域名：
https://registry.npmmirror.com
1. NPM（Node Package Manager）
NPM 的默认源位于国外，直接使用会导致下载延迟或失败。通过 npm config set 可实现全局永久切换，并在任何项目中生效。
配置步骤
在终端打开命令行，执行：
npm config set registry https://registry.npmmirror.com
验证方式
npm config get registry # 输出应为：https://registry.npmmirror.com
若显示上述 URL，则配置成功。
提示：该设置对全局安装和当前项目均有效。若需清除本地缓存，可先运行 npm cache clear --force，随后重新尝试下载。
2. PNPM（Performant npm）
PNPM 使用内容寻址存储，同样支持通过配置覆盖默认源地址。
全局永久生效
pnpm config set registry https://registry.npmmirror.com --global
手动编辑配置文件（适用于多项目环境）
在以下路径中创建或打开文件：
- Linux / macOS：
~/.config/pnpmrc - Windows (PowerShell / Command Prompt)：
%USERPROFILE%\.config\pnpmrc
配置内容示例：
registry=https://registry.npmmirror.com
验证方法（任意 PNPM 项目目录下）：
pnpm config get registry --local-only # 本地生效查询
pnpm config get registry --global # 全局生效查询
示例：若在
my-project/中运行pnpm config get registry，输出为https://registry.npmmirror.com，说明本地已生效；若在根目录执行，则表示全局已切换。
3. Yarn（Berry / Classic）
无论使用经典版（v1）还是新版核心仓库（Berry/v2），配置方式略有不同，但目标一致。
3.1 Yarn v2+（推荐）
在项目根目录的 .yarnrc.yml（或 ~/.yarnrc.yml）中添加：
# 简洁推荐格式
npmScopes:
'npmmirror.com':
npmPublishAccess: true # 仅对私有包必要，非必需可省略
registryByScope:
说明：
registryByScope为全局覆盖默认源地址；npmScopes指定所有在npmmirror.com下的依赖使用此地址。
3.2 Yarn v1（旧版）
若仍在使用旧版 yarn：
# 将当前项目的源地址临时设为镜像源，并标记为全局
npm config set registry https://registry.npmmirror.com --global
Yarn v1 默认会在本地项目目录下自动切换。若需全局统一，可配合 yarn config delete scope: 与 yarn config set 组合使用。
✅ 验证清单
完成任一工具的配置后，可执行以下命令确认效果：
# NPM
npm ls && npm config get registry # 检查 registry 配置
# PNPM
pnpm list || pnpm install --frozen-lockfile=false # 查看 registry 是否生效
# Yarn v2+
yarn cache clean && yarn add some-package @example/another-pkg # 观察下载速度提升
若所有 registry 查询结果均显示为 https://registry.npmmirror.com，则配置成功。
NPM / PNPM / Yarn 加速配置指南（阿里云镜像源）
在国内的开发环境中，默认的 npm / pnpm / yarn 会从国外下载依赖包，往往会出现下载超时或请求失败。为了提升项目加载速度，下面说明如何将这三种主流包管理器的加速域名切换为阿里云加速域 https://registry.npmmirror.com，并验证配置是否生效。
核心目标地址
所有操作均基于以下官方加速域名：
https://registry.npmmirror.com
1. NPM（Node Package Manager）
NPM 的默认源位于国外，直接使用会导致下载延迟或失败。通过 npm config set 可实现全局永久切换，并在任何项目中生效。
配置步骤
在终端打开命令行，执行：
npm config set registry https://registry.npmmirror.com
验证方式
npm config get registry # 输出应为：https://registry.npmmirror.com
若显示上述 URL，则配置成功。
提示：该设置对全局安装和当前项目均有效。若需清除本地缓存，可先运行 npm cache clear --force，随后重新尝试下载。
2. PNPM（Performant npm）
PNPM 使用内容寻址存储，同样支持通过配置覆盖默认源地址。
全局永久生效
pnpm config set registry https://registry.npmmirror.com --global
手动编辑配置文件（适用于多项目环境）
在以下路径中创建或打开文件：
- Linux / macOS：
~/.config/pnpmrc - Windows (PowerShell / Command Prompt)：
%USERPROFILE%\.config\pnpmrc
配置内容示例：
registry=https://registry.npmmirror.com
验证方法（任意 PNPM 项目目录下）：
pnpm config get registry --local-only # 本地生效查询
pnpm config get registry --global # 全局生效查询
示例：若在
my-project/中运行pnpm config get registry，输出为https://registry.npmmirror.com，说明本地已生效；若在根目录执行，则表示全局已切换。
3. Yarn（Berry / Classic）
无论使用经典版（v1）还是新版核心仓库（Berry/v2），配置方式略有不同，但目标一致。
3.1 Yarn v2+（推荐）
在项目根目录的 .yarnrc.yml（或 ~/.yarnrc.yml）中添加：
# 简洁推荐格式
npmScopes:
'npmmirror.com':
npmPublishAccess: true # 仅对私有包必要，非必需可省略
registryByScope:
说明：
registryByScope为全局覆盖默认源地址；npmScopes指定所有在npmmirror.com下的依赖使用此地址。
3.2 Yarn v1（旧版）
若仍在使用旧版 yarn：
# 将当前项目的源地址临时设为镜像源，并标记为全局
npm config set registry https://registry.npmmirror.com --global
Yarn v1 默认会在本地项目目录下自动切换。若需全局统一，可配合 yarn config delete scope: 与 yarn config set 组合使用。
✅ 验证清单
完成任一工具的配置后，可执行以下命令确认效果：
# NPM
npm ls && npm config get registry # 检查 registry 配置
# PNPM
pnpm list || pnpm install --frozen-lockfile=false # 查看 registry 是否生效
# Yarn v2+
yarn cache clean && yarn add some-package @example/another-pkg # 观察下载速度提升
若所有 registry 查询结果均显示为 https://registry.npmmirror.com，则配置成功。