前端项目 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)
相关推荐
zhangfeng113321 小时前
workbuddy ,node.js 每次会在 项目目录上安装 node_modules,能不能一次安装多次使用,为什么 npm 不把包装在全局
前端·npm·node.js
步十人21 小时前
【Vue3】前置知识简单概述(包括ES6核心语法,模块化ESM以及npm基础)
arcgis·npm·vue·es6
小虎3 天前
npm和pnpm常用命令
npm·pnpm·镜像源·缓存目录
YJlio3 天前
OpenClaw 2026.5.2 Beta 更新解读:外部插件安装、ClawHub / npm 切换与 Gateway 性能优化
性能优化·npm·gateway·飞书·多维表格·飞书aily·飞书妙搭
丑过三八线4 天前
npm 私有仓库找不到包的解决方案
前端·npm·node.js
一天 24h4 天前
Vue3父子组件传值:从零到精通
前端·javascript·vue.js·pycharm·npm·学习方法
一点事4 天前
pnpm:离线环境项目如何安装pnpm依赖(官方推荐:离线镜像)
npm
搬砖的前端4 天前
AI工具集:Git提交时使用AI进行CodeReview如何在前端应用构建NPM包
前端·人工智能·git·npm·codeview
chushiyunen4 天前
linux环境部署php、php-npm
linux·npm·php
在水一缸4 天前
警惕供应链陷阱:从 Red Hat npm 恶意包事件看依赖安全防护
前端·安全·npm·供应链安全·red hat·恶意包·依赖安全