Shopify CLI 报 Node 版本不兼容怎么处理

现象#

执行 shopify theme dev 或 shopify app dev 时报引擎版本不符，命令直接退出。

原因#

• 本机 Node 版本低于 CLI 要求（或高到尚未支持）
• 用 nvm 切换过版本，但全局安装的 CLI 绑在旧 Node 上
• 项目 .nvmrc 与实际使用的版本不一致

处理步骤#

1. 查看 CLI 文档要求的主版本，用 nvm 安装并切换（如 nvm use 20）
2. 切换后重装 CLI：npm i -g @shopify/cli@latest
3. 在项目根目录补 .nvmrc，团队统一版本
4. 清理旧全局包缓存后再执行 shopify version 验证

验收标准#

shopify version 正常输出；dev / push / deploy 命令均可执行。