前端项目 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)
相关推荐
AlfredZhao4 小时前
npm 源切换:一条命令搞定
npm
@tangguo1231 天前
npm 和 yarn 配置说明
前端·javascript·npm·node.js·yarn
.冰块.2 天前
Docker 镜像深度学习:分层 Copy‑on‑Write、Dockerfile 语法、Harbor 私有仓库实操
docker·容器·harbor·镜像·dockerfile·images
钝挫力PROGRAMER5 天前
npx 与 npm 全局安装/更新/卸载
npm·npx·mcp·dsh
天若有情6737 天前
开源轻量双语工具|一键批量查询 NPM 包历史下载量,支持按作者批量统计
javascript·npm·github pages·开源工具·netlify·前端开源·npm克隆量
柚稚姐姐11 天前
npm install pnpm -g npm error code EACCES npm error syscall symlink
前端·npm·node.js
jiao糖瓜子12 天前
Docker 完全指南:从镜像容器到生产部署
docker·容器·eureka·镜像·仓库
晴天1612 天前
npm install -f(--force)深度解析:作用原理、报错根源与风险避坑指南
前端·npm·node.js
晴天1612 天前
.npmrc 配置文件全解析:从换源到工程化的完整指南
npm·npmrc
晴天1613 天前
peerDependencies 全面解析:前端依赖生态的核心机制与实战指南
前端·npm