Shopify theme pull 教程：从在线商店安全拉取主题到本地
第一次把在线主题拉到本地时，最容易犯的错误不是命令写错，而是没有先确认目标主题、保存路径和本地文件会怎样变化。Shopify theme pull 会从商店下载主题文件；路径选错、在已有工作目录里直接执行，都会让后续对比和回滚变得麻烦。
这篇记录一次真实的只读拉取：我使用 Shopify CLI 4.7.0，从开发商店的在线主题 Sprout 拉取到一个全新的本地目录，共得到 637 个文件。随后运行 Theme Check，发现 113 个 error 和 1802 个 warning。这个结果也说明，拉取成功只代表同步完成，不代表主题代码已经通过质量检查。
Shopify theme pull 到底会做什么
shopify theme pull 用于把远程 Shopify 主题文件下载到本地。它和另外几个常见命令的职责不同：
theme pull：从商店拉取到本地；theme push：把本地文件同步到商店；theme package：只在本地生成可上传 ZIP；theme init：从主题仓库创建一个新的本地起点。
这次只执行了 theme list、theme pull 和本地 theme check，没有运行 push，也没有改动商店中的主题。拉取前如果还不熟悉文件分工，可以先看 Shopify Dawn 主题目录结构。
本次实测环境与结果
- 操作系统：Windows；
- Shopify CLI：4.7.0；
- 目标：开发商店的在线主题 Sprout；
- 本地目标：新建的空目录；
- 拉取结果：637 个文件，6 个顶层目录；
- Theme Check：128 个文件存在问题，113 个 error、1802 个 warning。
文章中的商店域名和主题 ID 使用占位符，避免把实际环境信息直接放进公开教程；命令结构、参数和结果都来自本次操作。
第一步：确认 Shopify CLI 与商店访问
先确认 CLI 版本：
shopify version再列出商店中的主题：
shopify theme list --store your-store.myshopify.com输出会区分 live、unpublished 和 development 等角色，并显示主题 ID。先用列表确认名称、角色和 ID，再执行拉取，比依赖交互式选择更适合记录和自动化。本次列表中明确确认 Sprout 是 live 主题后，才继续下一步。
第二步：拉到一个独立的新目录
我采用显式商店、主题 ID 和目标路径的写法：
shopify theme pull
--store your-store.myshopify.com
--theme 123456789
--path ./theme-backups/sprout-liveWindows PowerShell 里可以写成一行，或者把续行符改成反引号。公开脚本中不要写入密码或访问令牌；登录和权限应交给 Shopify CLI 自己管理。
第一次拉取时，我更倾向于使用一个不存在或为空的目录。这样得到的是清楚的远程快照，不会把旧项目文件、本地新增文件和远端文件混在一起。下载完成后，本次目录中有 assets、config、layout、locales、sections、snippets 与 templates 等标准主题内容。
theme、live 和 development 怎么选
非交互执行 Shopify theme pull 时，需要明确告诉 CLI 拉哪个主题。常见选择有：
--theme 123456789：按主题 ID 拉取，最明确，适合脚本和操作记录；--live：拉取当前在线主题，方便但要先确认你确实需要生产版本；--development：拉取当前开发主题，适合延续本机的开发会话。
我没有直接用 --live，而是先执行 theme list，再把确认过的主题 ID 写进命令。这样日志里能看出本次到底操作了哪一个主题，也减少在线主题切换后误拉其他版本的风险。
已有本地代码时，先理解删除行为
如果在已有项目目录中执行拉取，本地独有的文件可能被同步逻辑删除。官方命令提供 --nodelete，用于保留远程主题中不存在的本地文件：
shopify theme pull
--store your-store.myshopify.com
--theme 123456789
--path ./theme-working-copy
--nodelete--nodelete 不是版本管理的替代品。更稳妥的顺序仍然是：先提交或备份当前工作目录，再拉取到独立目录，对比差异后合并。对于长期维护的项目，我会保留一份未经修改的 raw pull，再复制出 working copy 开发。
只拉部分文件：only、ignore 与 .shopifyignore
只需要核对某类文件时，可以用 --only 限定范围；不希望下载某些文件时，可以用 --ignore。例如只拉取 JSON 模板：
shopify theme pull
--store your-store.myshopify.com
--theme 123456789
--only "templates/*.json"需要长期复用排除规则时，可以放进主题目录的 .shopifyignore。不过第一次备份在线主题时，我通常不急着排除文件：先获得完整快照，再根据项目实际情况整理规则，能减少“以为没用、后来才发现缺失”的情况。
第三步：拉取完成后立即做静态检查
进入本地目录后运行：
shopify theme check --path ./theme-backups/sprout-live这次命令成功下载 637 个文件，但 Theme Check 在 error 阈值下以退出码 1 结束：128 个文件存在问题，共 113 个 error 和 1802 个 warning。数量最多的是 DeprecatedFilter 和 ImgWidthAndHeight，同时还有未定义对象、变量命名和废弃标签等问题。
因此，在线运行中的主题不一定符合当前 CLI 的全部静态检查规则。先保留原始拉取副本，再在工作副本中按影响和风险分批处理，比一次性机械修改上千条警告更可靠。Theme Check 的报告、退出码和阈值可以继续参考 Shopify Theme Check 使用教程。
我实际采用的安全拉取流程
- 确认当前 Shopify CLI 版本和登录状态；
- 用
theme list核对主题名称、角色与 ID； - 创建带日期或版本标记的空目录；
- 使用显式
--store、--theme和--path拉取； - 保留原始快照，不直接在里面改代码；
- 复制为工作副本，运行 Theme Check；
- 用 Git 或目录对比审查改动；
- 确认无误后再考虑
theme push或 Shopify theme package。
常见问题
拉取在线主题会影响前台吗？
单纯执行 theme pull 是从商店读取并下载文件，不会像 theme push 那样把本地修改上传到主题。本次实际操作没有修改在线主题。但仍应核对命令方向，不要把 pull 和 push 写反。
为什么拉取成功，Theme Check 仍有错误？
拉取命令只负责文件同步，Theme Check 才负责静态检查。旧主题、第三方主题或长期维护的在线主题可能包含当前规则认为过时或有风险的写法，两者结果并不矛盾。
可以直接在拉下来的目录里开发吗？
可以，但我更建议保留一份原始快照，再从副本开始开发。这样遇到意外修改、错误批量替换或需要核对线上原样时，不必重新猜测基准版本。
Shopify theme pull 的命令本身不复杂，真正重要的是明确方向、主题 ID、目标目录和拉取后的检查步骤。把“远程快照”和“本地工作副本”分开，能让之后的修改、审查、打包与回滚都更清楚。
官方资料：theme pull 命令参考、Shopify CLI for themes、主题命令多环境支持、Shopify CLI 4.0 Changelog（访问于 2026 年 8 月 27 日；本文实测 Shopify CLI 4.7.0、在线主题 Sprout）。
