> For AI agents: the complete documentation index is available at https://docs.halo.run/llms.txt, the full documentation bundle is available at https://docs.halo.run/llms-full.txt.

# 商城开发

## 主题开发

### [开发概述](/developer-guide/shop/theme/overview.md)

- [页面如何渲染](/developer-guide/shop/theme/overview.md#页面如何渲染)
- [选择开发方式](/developer-guide/shop/theme/overview.md#选择开发方式)
- [版本与参考资料](/developer-guide/shop/theme/overview.md#版本与参考资料)

### [快速开始](/developer-guide/shop/theme/quick-start.md)

- [准备开发环境](/developer-guide/shop/theme/quick-start.md#准备开发环境)
- [创建商品列表页面](/developer-guide/shop/theme/quick-start.md#创建商品列表页面)
- [验证效果](/developer-guide/shop/theme/quick-start.md#验证效果)
- [继续适配](/developer-guide/shop/theme/quick-start.md#继续适配)

### [复用与覆盖模板](/developer-guide/shop/theme/template-reuse.md)

- [页面与模块的关系](/developer-guide/shop/theme/template-reuse.md#页面与模块的关系)
- [复用内置模块](/developer-guide/shop/theme/template-reuse.md#复用内置模块)
- [覆盖一个内容模块](/developer-guide/shop/theme/template-reuse.md#覆盖一个内容模块)
- [接入主题布局](/developer-guide/shop/theme/template-reuse.md#接入主题布局)

### [页面与模板变量](/developer-guide/shop/theme/pages-and-variables.md)

- [页面路由](/developer-guide/shop/theme/pages-and-variables.md#页面路由)
- [商品列表](/developer-guide/shop/theme/pages-and-variables.md#商品列表)
- [商品详情](/developer-guide/shop/theme/pages-and-variables.md#商品详情)
- [结算与支付页面](/developer-guide/shop/theme/pages-and-variables.md#结算与支付页面)
- [订单详情与游客访问](/developer-guide/shop/theme/pages-and-variables.md#订单详情与游客访问)
- [支付跳转中间页](/developer-guide/shop/theme/pages-and-variables.md#支付跳转中间页)

### [Finder API](/developer-guide/shop/theme/finder-apis.md)

- [productFinder.list(params)](/developer-guide/shop/theme/finder-apis.md#productfinderlistparams)
- [productFinder.getByHandle(handle)](/developer-guide/shop/theme/finder-apis.md#productfindergetbyhandlehandle)
- [productCategoryFinder.list(params)](/developer-guide/shop/theme/finder-apis.md#productcategoryfinderlistparams)
- [subscriptionFinder.subscription(handle, customerId)](/developer-guide/shop/theme/finder-apis.md#subscriptionfindersubscriptionhandle-customerid)
- [subscriptionFinder.list(params)](/developer-guide/shop/theme/finder-apis.md#subscriptionfinderlistparams)

### [使用商城组件](/developer-guide/shop/theme/components.md)

- [加载组件资源](/developer-guide/shop/theme/components.md#加载组件资源)
- [组件与参数](/developer-guide/shop/theme/components.md#组件与参数)
- [样式与语言](/developer-guide/shop/theme/components.md#样式与语言)

### [定制样式](/developer-guide/shop/theme/styling.md)

- [添加样式覆盖文件](/developer-guide/shop/theme/styling.md#添加样式覆盖文件)
- [常用变量](/developer-guide/shop/theme/styling.md#常用变量)
- [避免样式冲突](/developer-guide/shop/theme/styling.md#避免样式冲突)
- [暗色模式与窄屏](/developer-guide/shop/theme/styling.md#暗色模式与窄屏)

### [源码二次开发](/developer-guide/shop/theme/source-development.md)

- [准备源码与工具](/developer-guide/shop/theme/source-development.md#准备源码与工具)
- [合并 workspace 与依赖](/developer-guide/shop/theme/source-development.md#合并-workspace-与依赖)
- [接入主题资源入口](/developer-guide/shop/theme/source-development.md#接入主题资源入口)
- [处理图库与模板](/developer-guide/shop/theme/source-development.md#处理图库与模板)
- [开发与验证](/developer-guide/shop/theme/source-development.md#开发与验证)
- [维护改动](/developer-guide/shop/theme/source-development.md#维护改动)

### [前台接口与交易流程](/developer-guide/shop/theme/storefront-api.md)

- [选择接口与身份](/developer-guide/shop/theme/storefront-api.md#选择接口与身份)
- [Cookie 与 CSRF](/developer-guide/shop/theme/storefront-api.md#cookie-与-csrf)
- [查询商品与订阅计划](/developer-guide/shop/theme/storefront-api.md#查询商品与订阅计划)
- [购物车](/developer-guide/shop/theme/storefront-api.md#购物车)
- [准备结算](/developer-guide/shop/theme/storefront-api.md#准备结算)
- [读取和提交结算](/developer-guide/shop/theme/storefront-api.md#读取和提交结算)
- [支付](/developer-guide/shop/theme/storefront-api.md#支付)
- [游客订单与履约](/developer-guide/shop/theme/storefront-api.md#游客订单与履约)

### [测试与发布](/developer-guide/shop/theme/testing.md)

- [准备测试数据](/developer-guide/shop/theme/testing.md#准备测试数据)
- [页面与交互检查](/developer-guide/shop/theme/testing.md#页面与交互检查)
- [样式与兼容性](/developer-guide/shop/theme/testing.md#样式与兼容性)
- [常见问题](/developer-guide/shop/theme/testing.md#常见问题)
- [打包与升级](/developer-guide/shop/theme/testing.md#打包与升级)

### [版本差异](/developer-guide/shop/theme/api-changelog.md)

- [Halo 商城版 2.27](/developer-guide/shop/theme/api-changelog.md#halo-商城版-227)
- [Halo 商城版 2.23.2](/developer-guide/shop/theme/api-changelog.md#halo-商城版-2232)
- [Halo 商城版 2.23](/developer-guide/shop/theme/api-changelog.md#halo-商城版-223)
- [选择对应源码](/developer-guide/shop/theme/api-changelog.md#选择对应源码)