使用npm install <GitHub链接>时，从NPM而非GitHub拉取包的问题

我之前也碰到过类似的npm安装同名GitHub包被跳转到npm官方包的问题，给你几个亲测有效的解决步骤：

• 彻底清理缓存与旧依赖
  首先清空npm的缓存，避免旧的包信息干扰：

  npm cache clean --force
  

  接着删除项目里的node_modules文件夹和package-lock.json（如果用yarn的话就删yarn.lock），这些文件里可能已经记录了错误的包源。

• 确保package.json依赖写法精准
  直接在dependencies里指定完整的GitHub仓库地址（记得加.git后缀），这样npm就不会去npm仓库找同名包了：

  "dependencies": {
    "react-daterange-picker": "git+https://github.com/wojtekmaj/react-daterange-picker.git"
  }
  

  如果你想锁定某个分支或commit，还可以在地址后面加#分支名或#commit哈希，比如：

  "react-daterange-picker": "git+https://github.com/wojtekmaj/react-daterange-picker.git#main"
  

• 直接安装时用完整的仓库地址
  执行安装命令时，一定要带.git后缀，避免npm解析歧义：

  npm install git+https://github.com/wojtekmaj/react-daterange-picker.git
  

  或者明确指定包名+地址的形式，进一步避免混淆：

  npm install react-daterange-picker@git+https://github.com/wojtekmaj/react-daterange-picker.git
  

• 临时切换npm官方源试试
  如果你用了第三方npm镜像源，可能存在解析缓存问题，先切回官方源再安装：

  npm config set registry https://registry.npmjs.org/
  npm install
  

• 强制跳过缓存安装
  如果上面的步骤还不行，直接用--no-cache参数强制npm重新拉取依赖：

  npm install --no-cache
  

为什么会出现这个问题？ #

因为onefinestay的react-daterange-picker是发布到npm官方仓库的正式包，而wojtekmaj的版本可能没发布到npm。npm在解析依赖时，会优先匹配npm仓库里的同名包，哪怕你写了GitHub链接——如果缓存里有旧的包信息，或者链接写法不规范，就会触发这个优先级逻辑，导致安装错包。

内容的提问来源于stack exchange，提问作者Hybrid