NPM 中国加速配置指南

NPM 中国加速配置指南

由于网络环境原因，国内开发者使用 NPM 官方源时经常遇到速度慢或连接失败的问题。本文提供完整的 NPM 中国加速配置方案。

快速配置

方法一：淘宝镜像（推荐）

# 设置淘宝镜像
npm config set registry https://registry.npmmirror.com

# 验证配置
npm config get registry

方法二：使用 cnpm

# 安装 cnpm
npm install -g cnpm --registry=https://registry.npmmirror.com

# 使用 cnpm 替代 npm
cnpm install package-name

推荐镜像源

| 镜像源 | 地址 | 维护方 | 推荐度 | |--------|------|--------|--------| | 淘宝镜像 | https://registry.npmmirror.com | 阿里云 | ★★★★★ | | 腾讯云镜像 | https://mirrors.cloud.tencent.com/npm/ | 腾讯云 | ★★★★ | | 华为云镜像 | https://mirrors.huaweicloud.com/repository/npm/ | 华为云 | ★★★★ |

配置方法

全局配置

# 查看当前配置
npm config list

# 设置镜像源
npm config set registry https://registry.npmmirror.com

# 恢复官方源
npm config set registry https://registry.npmjs.org

# 删除镜像配置
npm config delete registry

项目级配置

在项目根目录创建 .npmrc 文件：

registry=https://registry.npmmirror.com

临时使用

# 临时指定镜像源安装
npm install --registry https://registry.npmmirror.com

# 安装单个包时指定
npm install package-name --registry https://registry.npmmirror.com

使用 nrm 管理多镜像源

nrm 是一个 NPM 镜像源管理工具，可以快速切换不同的镜像源。

# 安装 nrm
npm install -g nrm

# 查看可用镜像源
nrm ls

# 切换到淘宝镜像
nrm use taobao

# 测试各镜像源速度
nrm test

# 添加自定义镜像源
nrm add custom https://custom.registry.com

其他包管理器配置

PNPM

pnpm config set registry https://registry.npmmirror.com
pnpm config get registry

YARN

yarn config set registry https://registry.npmmirror.com
yarn config get registry

缓存管理

# 查看缓存目录
npm config get cache

# 清理缓存
npm cache clean --force

# 设置缓存目录
npm config set cache /path/to/cache

常见问题

设置镜像后仍然很慢

1. 尝试不同镜像源：nrm test 测速后选择最快的 2. 清理 DNS 缓存：

• macOS：sudo dscacheutil -flushcache

• Windows：ipconfig /flushdns

3. 清理 npm 缓存：npm cache clean --force

某些包无法下载

镜像源可能存在同步延迟，临时切换到官方源安装：

npm install package-name --registry https://registry.npmjs.org

权限问题

# macOS / Linux：修改 npm 全局目录权限
sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}

或使用 nvm 管理 Node.js 版本，避免权限问题。

配置好镜像源后，安装 Claude Code 或 Codex 的速度会大幅提升。