Shopware 6.5升级后Node18运行build.sh报错：找不到vue-template-compiler@2.6.14

问题根源 #

Shopware 6.5对Node版本、依赖版本存在特定兼容要求，Node 18下包管理器的版本解析逻辑变化，或是本地依赖缓存冲突，导致无法拉取指定版本的vue-template-compiler。

解决步骤 #

• 清理本地依赖缓存
  先删除项目根目录的node_modules文件夹，再清理包管理器缓存：

  # npm 用户执行
  rm -rf node_modules
  npm cache clean --force
  
  # 若使用 yarn，执行
  rm -rf node_modules
  yarn cache clean
  

• 手动安装兼容依赖或切换Node版本
  尝试手动安装指定版本的依赖：

  npm install vue-template-compiler@^2.6.14 --save-dev
  

  如果仍失败，可切换到Shopware 6.5官方推荐的Node 16版本（用nvm快速切换）：

  nvm install 16
  nvm use 16
  

• 重新安装项目依赖后再构建
  先分别为前端模块重新安装依赖，再执行构建脚本：

  # 处理Storefront依赖
  cd storefront
  npm install
  
  # 处理Administration依赖
  cd ../administration
  npm install
  
  # 返回根目录执行构建
  cd ../
  ./bin/build.sh
  

• 排查npm镜像源问题
  若使用国内镜像源可能存在版本同步延迟，切换回官方npm源尝试：

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

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