Shopify CLI 与 Headless

Shopify CLI 在 WSL 里路径报错怎么修

现象#

Git Bash 里跑 shopify theme dev 提示找不到主题目录,直接退到上一级;切到 WSL 又报 command not found: shopify,而同一条命令在 PowerShell 里正常。

原因#

  • Windows 版 CLI 装在 AppData 的 npm 目录,WSL 的 PATH 不继承 Windows 路径
  • Git Bash 会把 /c/Users 形式转成 C:/Users,Node 侧再拼一次盘符就得到无效路径
  • 主题识别依赖当前目录下存在 layout 与 config,从父目录启动时这两个目录都不在
  • 仓库在 Windows 侧开了 autocrlf,JSON 带回车符,上传后 section schema 解析失败

处理步骤#

  1. 确认命令来源:which shopify,Windows 与 WSL 各装一份,不要交叉调用
  2. 在 WSL 内重装:npm i -g @shopify/cli,Node 用 nvm 升到 22.12 以上
  3. 始终在主题根目录执行,或显式传 --path /mnt/c/Users/me/theme
  4. Git Bash 里路径加引号避免转换:shopify theme push --path '/c/theme'
  5. 统一换行:git config core.autocrlf false 后重新检出,确认 JSON 里没有 CR

验收标准#

shopify theme dev 能打印本地预览地址,shopify theme check 不再报 schema 解析错误。

本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。