当前唯一有效的淘宝镜像地址是 https://registry.npmmirror.com,旧地址 npm.taobao.org 已停服且证书过期,需立即执行 npm config set registry https://registry.npmmirror.com 切换,并验证生效。

直接改,别犹豫——现在唯一有效的淘宝镜像地址是 https://registry.npmmirror.com,旧地址 npm.taobao.org 已停服且证书过期,强行用会报 ERR_SSL_CERT_HAS_EXPIRED。
确认当前 registry 是否已失效
执行命令检查当前源:
npm config get registry
如果输出是 https://registry.npm.taobao.org 或 https://registry.npmjs.org(但安装极慢),说明需要切换。注意:某些 Linux 发行版预装的 Node.js 可能自带过期配置,即使没手动设过也可能中招。
- 返回
undefined?说明配置缺失,npm会退回到官方源,同样要改 - 返回带
taobao.org的地址?立刻换,否则后续npm install会卡在 TLS 握手或 404 - 不确定是否被项目级
.npmrc覆盖?加-l参数看完整配置链:npm config list -l
永久切换到新淘宝镜像源(推荐)
运行这一条命令即可写入用户级配置(路径为 ~/.npmrc):
npm config set registry https://registry.npmmirror.com
它不会动系统级或项目级配置,只影响你当前用户所有全局和普通安装行为。
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq(Cortex‑A9/A53 + FPGA)Linux 环境,调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查,支持 PetaLinux 开发。
- 执行后务必验证:
npm config get registry必须精确返回https://registry.npmmirror.com(末尾无斜杠也可,但推荐带) - 如果失败,常见原因是权限问题:Linux 下若曾用
sudo npm安装过全局包,~/.npmrc可能属 root,此时需先sudo chown $USER:$USER ~/.npmrc - 不放心?直接编辑
~/.npmrc,确保只有一行:registry=https://registry.npmmirror.com(等号前后不要空格)
临时使用淘宝源(适合 CI/CD 或单次调试)
不需要改任何配置,每次安装时显式指定:
npm install express --registry=https://registry.npmmirror.com
这个参数优先级最高,会覆盖 .npmrc 里所有 registry 设置。
- 适合 Jenkins/GitLab CI 脚本中避免污染构建机环境
- 注意:不能省略
--registry=中的等号,写成--registry https://...会报错Unknown option: '--registry' - 想对整个
package.json生效?用npm ci --registry=https://registry.npmmirror.com
换源后仍失败?重点查这三处
换源不是万能药,Linux 下常因环境叠加出问题:
-
npm cache clean --force:旧缓存可能含损坏的元数据,尤其从旧 taobao 源拉过的包 - 代理设置冲突:检查
npm config get proxy和https-proxy,国内多数情况应为空;如有值,用npm config delete proxy清掉 - nvm 用户注意:
nvm自身也有镜像配置(~/.nvm/.nvmrc或$NVM_DIR/settings.txt),若同时配了npm_mirror,需同步改为https://npmmirror.com/mirrors/npm/
真正卡住的时候,往往不是源地址错了,而是缓存、代理、nvm 镜像三者之一悄悄顶替了你的新设置。


















