You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

运行npm create @shopify/hydrogen@latest遇依赖冲突,常规解法无效

解决Hydrogen项目初始化时的peer依赖冲突问题

直接指定兼容版本初始化

跳过默认的最新版初始化流程,手动锁定能匹配的版本组合:

  • 方法1:用--template参数指定官方兼容的模板版本,这类模板会预先锁定适配的Remix版本:
    npm create @shopify/hydrogen@latest -- --template hydrogen-template-skeleton@latest
    
  • 方法2:中断自动安装后手动修正依赖
    1. 完成初始化提问后,立即终止自动安装进程
    2. 打开生成的package.json,将@remix-run/react版本改为^1.19.1,同时同步修改@remix-run/node、@remix-run/server-runtime等关联Remix包的版本为1.19.1
    3. 删除自动生成的package-lock.json
    4. 重新执行安装:
      npm install
      

强制忽略peer依赖冲突(npm 7+适用)

使用--force参数强制安装,直接跳过peer版本不匹配的校验:

npm create @shopify/hydrogen@latest -- --force

如果已经初始化完成,也可以单独执行:

npm install --force

切换包管理器尝试

不同包管理器的依赖解析逻辑有差异,改用pnpm或yarn可能自动解决冲突:

  • pnpm初始化命令:
    pnpm create @shopify/hydrogen@latest
    
  • yarn初始化命令:
    yarn create @shopify/hydrogen@latest
    

内容的提问来源于stack exchange,提问作者Sweta Jha

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.14 17:22:03