Shopify App 与 API 开发专题
Shopify 的扩展方式这两年换了一轮： Scripts 已停止执行，Script Tag 正在退场，REST API 进入维护模式。新项目要从 GraphQL、Functions、扩展（Extensions）和 Webhook 起步，而不是照搬老教程。下面按「先读什么」整理了站内相关文章。
一、按你的情况选读
| 你的情况 | 先读 | 再读 |
|---|---|---|
| 第一次做 Shopify App | App 开发完整指南 | Admin API 实战 |
| 要对接 ERP、仓库等外部系统 | Admin API 实战 | Webhook 开发指南 |
| 原来靠 Scripts 做折扣、运费、支付规则 | Scripts 迁移 Functions | Discount Function 买赠实战 |
| 应用还在用 Script Tag 或改结账页 | Script Tag 弃用与迁移 | Checkout Extensibility 迁移 |
| 考虑做 Headless 前端 | Headless 架构入门 | Headless 什么时候值得做 |
| 想让 AI 助手接入店面购物 | Storefront MCP 简介 | Headless 架构入门（Storefront API） |
一句话原则：新项目优先 GraphQL 和官方扩展点；Webhook 先响应再异步处理；Headless 要等主题和扩展确实解决不了问题再立项。
二、全部教程
按最近更新时间排列：
- Shopify Scripts 迁移 Functions 实战指南Shopify Scripts 到 Functions 的迁移指南。覆盖 Scripts 于 2026-06-30 停用的时间线、Functions 能力对比、Shopify Flow 自动化、典型场景实现（折扣 / 运费 / 支付）、与第三方自动化工具的协同。Shopify Functions折扣迁移更新于 2026-09-17
- Shopify Headless不是每个 Shopify 店都该做 Headless。本指南从业务判断、Hydrogen/Next.js 选型、Storefront API、缓存、SEO、应用兼容与迁移风险出发，帮工程和业务团队做可落地的决策。SEOHeadless更新于 2026-07-29
- Shopify Checkout Extensibility 迁移实战面向 Shopify Plus 商家与开发团队的 Checkout Extensibility 指南：哪些能力可以定制、checkout.liquid 迁移如何盘点、Checkout UI Extension 怎么开发，以及上线前必须验证的结账场景。结账Shopify Plus更新于 2026-07-29
- Shopify LINE 到货通知实现面向台日韩市场 Shopify 独立站的 LINE 补货通知完整实现方案。覆盖 LINE Messaging API 配置、商品页订阅表单、metafield / 外部数据库选型、库存 Webhook 监听、消息发送与防骚扰、合规与隐私要点。Webhook库存更新于 2026-05-13
- Storefront MCP 简介面向 Shopify 应用开发者与 AI 工程团队的 Storefront MCP 导读。覆盖 Model Context Protocol 在店面场景的定位、与 Dev MCP / AI Toolkit 的差异、典型工具列表、上线前的测试与合规检查、与传统对话客服的对比。MCPAI客服更新于 2026-05-13
- Shopify Admin API 实战Shopify Admin API 进阶开发指南。覆盖 GraphQL 与 REST 选型决策、限流机制与查询成本、批量操作、Webhook 集成、Access Token 管理、API 版本策略、典型集成场景。Admin APIWebhook更新于 2026-05-12
- Shopify App 开发完整指南面向 Shopify App 开发者的系统化指南。覆盖 App 类型选择、OAuth 认证、GraphQL Admin API 集成、App Extensions（Theme / Checkout / Admin UI）、Webhook 与会话管理、性能优化、App Store 审核与部署。Admin APIWebhook结账更新于 2026-05-12
- Shopify Headless 架构入门Shopify Headless（无头）架构的入门指南。覆盖架构原理、与传统主题的关键差异、适用与不适用场景、Hydrogen / Next.js 选型决策、典型案例与迁移建议。Headless更新于 2026-05-12
- Shopify Webhook 开发指南面向开发者的 Shopify Webhook 完整指南。覆盖 Webhook 类型、订阅创建、HMAC 签名验证、5 秒响应限制、重试机制、幂等处理、错误监控、典型集成场景与生产部署。Webhook更新于 2026-05-12
- Shopify AI Toolkit介绍 Shopify 官方 AI Toolkit 的安装方式与实用场景，帮助开发者在主题开发、SEO 批量优化、商品数据整理和应用开发中更高效地使用 AI 工具SEOMCPAI更新于 2026-04-29
- Shopify Discount Function 买赠实战基于 Shopify Discount Function + Cart Transform Function（JavaScript）实现买 A 赠 B、订单满 X 赠 B；并说明多商户场景下购物车 Widget 通过 Theme App Extension（App 嵌入 / App 区块）接入店面与结账边界Shopify Functions结账折扣更新于 2026-04-16
- Shopify 第三方集成指南详细介绍 Shopify 主题中集成 Google Analytics、Facebook Pixel、Klaviyo、Intercom 等第三方服务的完整指南，包含代码示例和最佳实践。LiquidApp 管理更新于 2025-09-29
三、时效资讯
弃用时间线和 API 限制可能调整，以文中标注的更新日期和 shopify.dev 官方原文为准：
四、相关但不在本专题的文章
- Shopify Metafields 与 Metaobjects — App 和主题之间传数据的常用载体
- Shopify Flow 自动化实战 — 不写代码能解决的自动化先用 Flow
- Shopify 应用审计 — 商家侧清理应用与权限
五、常见问题（FAQ）
Q：新项目用 REST 还是 GraphQL？ A：优先 GraphQL。REST Admin API 自 2024 年 10 月起进入维护模式，只做安全修复，部分新功能只在 GraphQL 提供；REST 只在维护老代码或简单单资源 CRUD 时还可以用。两者限流方式也不同：REST 按请求数，GraphQL 按查询成本。详见 Admin API 实战。
Q：Webhook 为什么会重复收到同一事件？
A：endpoint 5 秒内没响应、返回非 2xx 或网络不可达时，Shopify 会自动重试，最多 19 次、分布在 48 小时内，48 小时后仍失败就放弃推送。正确做法是收到后立即返回 200、再异步处理，并用 X-Shopify-Webhook-Id 做幂等判断。详见 Webhook 开发指南。
Q：Script Tag 和 Shopify Scripts 是一回事吗？ A：不是。Script Tag 是应用往店面注入的 JavaScript，店面上 2027 年 3 月 1 日起不再注入，2026 年 10 月 1 日起应用已不能新建或更新 Script Tag；Shopify Scripts 是 Plus 专属的 Ruby 脚本，已于 2026 年 6 月 30 日停止执行，替代方案是 Shopify Functions。详见 Script Tag 弃用与迁移 和 Scripts 迁移 Functions。
Q：给单个客户做的工具，要做 Public App 还是 Custom App？ A：单一商家、内部业务、不上架的用 Custom App，不需要审核；给多个客户内部分发的用 Unlisted Public App；开放给所有商家的才做 Listed Public App，需要通过 App Store 审核。旧的 Private App 已废弃。详见 App 开发完整指南。
小结：App 与 API 开发专题按「App 选型 → Admin API 与限流 → Webhook → Functions 与结账扩展 → 弃用迁移 → Headless 与 MCP」的顺序组织。这个领域的时间线和接口变化很快，动手前先对照 shopify.dev 和 changelog 核实当前版本。