前端项目 npm 镜像使用的顺序,和优先级顺序

所有场景镜像优先级总结

优先级从高到低如下,没有 fallback 逻辑:

  1. package.json 文件中的 /URL/本地格式路径
    1. Git URL
    2. HTTP(s) URL / 压缩包 URL
    3. file: 本地路径
    4. link
    5. direct source 不受 lockfile 和 .npmrc 影响,这些来源强绑定,不走 registry,也不走镜像,没有 fallback
  1. lock 文件中 resolved 的镜像地址
    1. 若 lockfile 记录了 tarball URL,则强制使用
    2. 仅适用于 registry 包(不是 direct source)
    3. direct source 不受 lockfile 控制
  1. 项目级别的 .npmrc 文件中的配置
    1. @scope:registry=xxx(精确匹配)
    2. registry=xxx(全局 registry)
    3. 说明
      • scope 不因位置变化优先级
      • 如果 key 完全相同(如 registry 重复),后者覆盖前者
  1. 用户级别的 .npmrc 文件中的配置
    1. @scope:registry=xxx(精确匹配)
    2. registry=xxx(全局 registry)
  1. 系统级别的 .npmrc 文件中的配置
    1. @scope:registry=xxx(精确匹配)
    2. registry=xxx(全局 registry)
相关推荐
Lyra_Infra13 小时前
OpenClaw 升级及 Channel 安装故障排查与遗留问题分析
后端·npm
紫禁玄科2 天前
Shai-Hulud:npm生态的自我复制蠕虫风暴
前端·npm·node.js
fastjson_5 天前
Hadoop之Yarn
大数据·hadoop·npm
晓得迷路了5 天前
栗子前端技术周刊第 141 期 - Next.js 16.3、npm 安全事件、2026 CSS 现状调查报告结果...
前端·javascript·npm
周小董5 天前
[1367]npm 安装 canvas 报错 node-gyp ERR
前端·npm·node.js
MartinYeung57 天前
npm爆发大规模供应链攻击 蠕虫污染 2000+ 个包版本: 深度技术剖析
前端·npm·node.js
无责任此方_修行中10 天前
换个版本号就能升级?可没那简单:pnpm 11 升级踩坑记
javascript·后端·npm
leslie11812 天前
npm常用命令
前端·npm
不在逃避q13 天前
Trae/Vs Code/Cursor命令行无法跑npm命令
前端·arcgis·npm
半句唐诗14 天前
我是如何通过 Access Token 成功发布第一个 npm 包的
前端·npm·node.js