Shopify CLI 命令是什么、怎么用：一份开发者指南

Shopify 发布了一份面向开发者的 Shopify CLI 使用指南，说明这套官方命令行工具如何覆盖应用、主题和 Hydrogen 店面的完整开发流程。

工具定位与安装条件

Shopify CLI 安装在开发者本机、从终端运行，是官方支持的应用、主题和 Hydrogen 店面构建方式。它负责项目脚手架、本地开发服务器、用真实店铺数据测试，以及部署到 Shopify 环境。指南特别指出，使用 app extensions 构建自定义应用或使用 Hydrogen 框架时，CLI 的价值最大，因为这两类工作没有可点选操作的替代方案。

安装前本地环境需满足：Node.js 22.12 或更高版本；npm、Yarn 1.x 或 pnpm 等包管理器；Git 2.28.0 或更高版本。之后可用 `npm install -g @shopify/cli@latest` 全局安装，macOS 也可通过 Homebrew 安装。

命令结构与功能分类

所有命令遵循 `shopify [topic] [command]` 语法。topic 指明项目类型（app、theme、hydrogen）或通用主题（config、auth），command 指明具体任务。例如 `app config link` 会写入 shopify.app.toml 并关联 Dev Dashboard 中的应用记录；`theme dev` 把本地主题上传为开发主题并给出自动更新的预览链接，该临时副本在闲置七天后删除。

指南把命令归为几类：脚手架（如 `app init`）、本地开发（如 `theme dev`）、检查与同步（如 `app config pull`）、质量检查（如 `theme check`）、部署与发布（如 `app deploy`）、监控（如 `app logs`）。

应用与主题的典型流程

应用开发分四步：`app init` 创建项目与 Dev Dashboard 记录；`app dev` 构建、隧道连接到开发店铺并监听改动；`app generate extension` 添加结账 UI 扩展或 functions 脚手架，`app config validate` 提前发现配置错误；`app deploy` 推送新版本，`app release` 将已部署版本转为线上。

主题开发则从 `theme init` 克隆 Skeleton 等起始主题开始，用 `theme dev` 预览，用 `theme check` 检查 Liquid 语法错误和最佳实践违规（如标签缺少 width 或 height 属性），用 `theme console` 针对真实店铺数据交互测试 Liquid 逻辑，用 `theme pull` 和 `theme push` 双向同步文件，最后发布。

编辑部观察

这份指南的实用价值在于把分散的命令按开发阶段归类，并明确了环境版本门槛。对准备接入 Shopify 应用或主题开发的团队，可先核对 Node.js 与 Git 版本，再按“脚手架—本地预览—检查—部署”的顺序跑通一条最小流程，确认 Dev Dashboard 关联和开发主题预览正常后再扩展。指南未涉及具体定价、命令执行耗时或团队协作配置，这些需另行查证。