本资料是面向 Shopify 平台开发的综合指南，涵盖应用、扩展、主题与 API 集成。
用途与平台组成 资料聚焦在 Shopify 上进行开发，核心组件包括：Shopify CLI（开发工作流工具）、GraphQL Admin API（推荐的数据操作主 API）、REST Admin API（维护模式下的旧版 API）、Polaris UI（一致界面的设计系统）以及 Liquid（主题模板语言）。扩展点包括：Checkout UI（定制结账体验）、Admin UI（扩展后台仪表盘）、POS UI（销售点定制）、Customer Account（购后页面）和 Theme App Extensions（嵌入式主题功能）。
主要能力与适用选择 资料给出何时构建什么的选择依据：需要集成外部服务、跨多店铺添加功能、构建面向商家的后台工具、程序化管理店铺数据、实现复杂业务逻辑或对功能收费时，构建应用；需要定制结账流程、为后台页面添加字段/功能、为零售创建 POS 操作、实现折扣/支付/配送规则或扩展客户账户页面时，构建扩展；需要自定义店面设计、打造独特购物体验、定制商品/集合页面、实现品牌化布局或修改首页/内容页时，构建主题。也给出组合方式：应用负责后端逻辑与数据，主题扩展提供店面 UI，例如商品评论、心愿单、尺码指南。
使用方式（命令与代码片段） 资料提供 CLI 安装与初始化命令，例如：npm install -g @shopify/cli@latest、shopify version、shopify app init、shopify app dev、shopify app generate extension --type checkout_ui_extension、shopify app deploy，以及主题相关命令 shopify theme init、shopify theme dev、shopify theme pull --live、shopify theme push --development。开发工作流分为应用开发、扩展开发和主题开发，并给出访问范围配置示例（shopify.app.toml 中的 [access_scopes] scopes = "read_products,write_products,read_orders"）。资料还包含三段代码片段：GraphQL 商品查询、基于 React 的结账扩展、Liquid 商品展示循环，以及一个交互式初始化脚本命令 python scripts/shopify_init.py。
最佳实践与限制 在 API 使用上：新开发优先 GraphQL、只请求所需字段以降低成本、大数据集实现分页、批量处理使用批量操作、遵守速率限制（GraphQL 基于成本）。安全方面：API 凭据存入环境变量、验证 webhook 签名、公开应用使用 OAuth、申请最小访问范围、嵌入式应用使用会话令牌。性能方面：适当缓存 API 响应、压缩主题图片、降低 Liquid 逻辑复杂度、扩展使用异步加载、监控 GraphQL 查询成本。测试方面：使用开发店铺、跨不同店铺计划测试、验证移动端响应式、检查可访问性、验证 GDPR 合规。资料也列出排错方法：速率限制错误（监控 X-Shopify-Shop-Api-Call-Limit 头、指数退避、批量操作）、认证失败（校验访问令牌、检查范围、确认 OAuth 流程完成）、扩展不显示（目标是否正确、是否已发布、应用是否已安装）、Webhook 未收到（URL 可访问性、签名验证、Partner Dashboard 日志）。
参考资料与版本说明 资料给出官方文档链接：Shopify Docs、GraphQL API、Shopify CLI、Polaris，以及工具（GraphiQL Explorer、Partner Dashboard、开发店铺）。API 版本按季度发布（YYYY-MM 格式），资料标注当前为 2025-01，每个版本支持 12 个月，升级前需测试。资料说明该技能覆盖截至 2025 年 1 月的 Shopify 平台，最新更新以官方文档为准。
适用场景 适合需要在 Shopify 上开发应用、扩展或主题，并希望了解 CLI 工作流、API 调用、扩展类型选择、安全与性能实践及常见排错的开发者。
限制 资料未提供收费、价格、具体平台效果或确切使用步骤之外的信息；缺失事实暂未提供。