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 解析失败
处理步骤#
- 确认命令来源:
which shopify,Windows 与 WSL 各装一份,不要交叉调用 - 在 WSL 内重装:
npm i -g @shopify/cli,Node 用 nvm 升到 22.12 以上 - 始终在主题根目录执行,或显式传
--path /mnt/c/Users/me/theme - Git Bash 里路径加引号避免转换:
shopify theme push --path '/c/theme' - 统一换行:
git config core.autocrlf false后重新检出,确认 JSON 里没有 CR
验收标准#
shopify theme dev 能打印本地预览地址,shopify theme check 不再报 schema 解析错误。
本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。