先判断问题出现在哪里
在本地开发 Shopify 主题，你需要一个工具来充当本地电脑和 Shopify 服务器之间的“搬运工”。
核心逻辑是：双向同步与热更新（HMR）。
Shopify CLI（Command Line Interface）不仅能将你本地修改的代码瞬间推送到云端，还能在本地启动一个代理服务器。当你在 VS Code 里保存文件时，浏览器会自动刷新（甚至无刷新替换 CSS），让你像开发本地 Vue/React 项目一样丝滑地开发 Shopify 主题。
实战步骤
核心命令 1：环境初始化与登录
操作路径：系统终端
-
登录授权：运行
shopify auth login。这会打开浏览器，让你登录 Shopify Partner 账号。这是 CLI 3.x 的重大升级，彻底淘汰了以前容易泄露的 API 密码。 -
退出登录：如果你需要切换到另一个客户的 Partner 账号，运行
shopify auth logout清除本地凭证。
核心命令 2：启动本地开发服务器 (Dev)
操作路径：项目根目录终端
- 运行：
shopify theme dev --store=your-store.myshopify.com - 底层原理：这个命令会在你的店铺里创建一个隐藏的、临时的“Development Theme（开发主题）”。你本地的所有修改都会实时同步到这个隐藏主题上，绝对不会影响线上正在营业的 Live 主题。
-
指定端口：如果默认的 9292 端口被占用，可以使用
--port=8080参数。
核心命令 3：拉取与推送代码 (Pull & Push)
| 命令 | 使用场景 | 注意事项 |
|---|---|---|
shopify theme pull |
客户在后台修改了文案或颜色，你需要将这些云端的 JSON 配置拉取到本地电脑。 | 运行后会列出店铺里的所有主题，让你选择从哪个主题拉取。通常选择 Live 主题。 |
shopify theme push |
本地开发完成，准备将代码上传到店铺的某个未发布主题中。 | 极其危险！ 如果你选择了 Live 主题，会直接覆盖线上代码。建议推送到一个新建的 Unpublished 主题。 |
核心命令 4：主题打包与分享 (Package & Share)
操作路径：项目根目录终端
-
打包主题：运行
shopify theme package。CLI 会自动忽略.git、node_modules等开发文件，将主题打包成一个标准的.zip文件，可直接在 Shopify 后台上传或提交到 Theme Store。 -
分享预览：运行
shopify theme share。生成一个永久的预览链接（不依赖你本地电脑是否开机），方便发给客户或 QA 团队进行验收测试。
常见误区与处理方法
误区一：多人协作时共用同一个 Development Theme
规避方法：当团队里的前端 A 和前端 B 同时对同一个店铺运行 shopify theme dev 时，如果他们没有正确配置环境，CLI 可能会把他们的修改推送到同一个隐藏的开发主题上，导致代码互相覆盖、浏览器疯狂刷新。Shopify CLI 会根据你本地电脑的系统用户名自动创建独立的开发主题（如 "Development (John)"）。 确保每个开发者使用自己的 Partner 账号登录，并在终端确认他们连接的是属于自己的开发主题 ID。
误区二：直接在 Live 主题上运行 shopify theme dev
规避方法：这是一个致命的误区！shopify theme dev 的机制是创建一个独立的开发主题，它不会直接修改 Live 主题。但是，如果你在运行 shopify theme dev 时，加上了 --theme=live 参数，CLI 会直接将你的本地代码热更新到线上营业的主题中！一旦你写错了一个标签，整个网站瞬间白屏，客户的订单直接归零。永远、永远、永远不要对 Live 主题运行 dev 命令。 所有的开发必须在独立的开发主题中进行，测试无误后再通过 Git 部署到线上。
误区三：忽略了 .shopifyignore 文件的配置
规避方法：如果你在本地使用了 Vite、Webpack 等构建工具，你的项目目录下会产生 src 源码文件夹和庞大的 node_modules。如果你不配置忽略文件，当你运行 shopify theme push 时，CLI 会试图把这几十兆的开发文件全部传到 Shopify 服务器上，导致推送极慢甚至报错。必须在项目根目录创建一个 .shopifyignore 文件，将所有非 Shopify 标准目录（如 src/, node_modules/, .env）全部排除。 确保只推送 layout, templates, sections, snippets, assets, config, locales 这 7 个标准文件夹。
FAQ
ShopifyCLI和ThemeKit应该先检查什么？
先在测试主题或测试页面中操作，并保留修改前版本和验证记录。不要同时改很多位置，先记录当前页面和数据，再处理最明确的问题。
需要马上安装新的 Shopify App 吗？
不一定。先判断主题现有功能、后台字段和少量代码能否解决。只有需要持续同步数据或复杂自动化时，再评估 App 的费用、脚本负担和卸载影响。
修改后怎么验证是否有效？
记录修改日期、页面 URL 和改动内容，再用实际页面、移动端、Google Search Console、Bing Webmaster Tools 或 GA4 检查结果。技术修改还要保留测试记录和回滚版本。
哪些情况不建议马上修改？
数据量太少、追踪没有配置、问题还没有复现，或者正在进行大型主题更新时，不建议一次性重做。先把问题拆开，确认影响范围后再改。