[跳到正文](#main-content)
[Sline](/)
Sline
[Sline 概览](/zh-cn/)[主题 Sections](/section/)[AST 浏览器](/sline-ast-explorer/)
指南
[Sline 模板入门](/sline-template/)[语法对比](/sline-vs-handlebars-vs-liquid/)[迁移实战](/liquid-handlebars-sline/)[Dawn 与 Bottle 对比](/Shopify-Dawn-vs-Shopline-Bottle/)[OS 3.0 迁移](/shopline-transformation/)[主题 CLI](/sline-theme-cli/)
MCP
[SHOPLINE Dev MCP](/mcp/)[Storefront MCP](/storefront-mcp/)[Shopline MCP](/shopline-mcp/)
工具
[SkuSync](/skusync/)[SHOPLINE 转 Shopify](/convert-shopline-csv-to-shopify-format/)[Shopify 转 SHOPLINE](/convert-shopify-csv-to-shopline-xlsx/)[AI 就绪检查器](/ai-checker/)[SkuSync 文档](/docs/)[Shopline Checker](/shopline-checker/)[Shopline Helper](/shopline-helper/)[ImgSEO](/imgseo/)[ImgSEO 指南](/imgseo-doc/)
菜单
## Sline
[Sline 概览](/zh-cn/)[主题 Sections](/section/)[AST 浏览器](/sline-ast-explorer/)
## 指南
[Sline 模板入门](/sline-template/)[语法对比](/sline-vs-handlebars-vs-liquid/)[迁移实战](/liquid-handlebars-sline/)[Dawn 与 Bottle 对比](/Shopify-Dawn-vs-Shopline-Bottle/)[OS 3.0 迁移](/shopline-transformation/)[主题 CLI](/sline-theme-cli/)
## MCP
[SHOPLINE Dev MCP](/mcp/)[Storefront MCP](/storefront-mcp/)[Shopline MCP](/shopline-mcp/)
## 工具
[SkuSync](/skusync/)[SHOPLINE 转 Shopify](/convert-shopline-csv-to-shopify-format/)[Shopify 转 SHOPLINE](/convert-shopify-csv-to-shopline-xlsx/)[AI 就绪检查器](/ai-checker/)[SkuSync 文档](/docs/)[Shopline Checker](/shopline-checker/)[Shopline Helper](/shopline-helper/)[ImgSEO](/imgseo/)[ImgSEO 指南](/imgseo-doc/)
[首页](/)/[Guides](/sline-template/)/认识 Sline
# Sline 模板语言入门
从对象、标签、过滤器、作用域和安全输出开始，建立开发 SHOPLINE Online Store 3.0 主题所需的 Sline 基础。
学习路径 1 / 6适合初级主题开发者最后核验：2026-07-28
本页目录
[Sline 解决什么问题](#sline-解决什么问题)[输出与 HTML 安全](#输出与-html-安全)[默认转义](#默认转义)[明确输出 HTML](#明确输出-html)[对象、属性与作用域](#对象属性与作用域)[标签：让模板产生结构](#标签让模板产生结构)[条件](#条件)[循环](#循环)[过滤器：改变输出](#过滤器改变输出)[数据类型与真假值](#数据类型与真假值)[一个完整的商品摘要](#一个完整的商品摘要)[开始编码前的检查清单](#开始编码前的检查清单)
本页目录
[Sline 解决什么问题](#sline-解决什么问题)[输出与 HTML 安全](#输出与-html-安全)[默认转义](#默认转义)[明确输出 HTML](#明确输出-html)[对象、属性与作用域](#对象属性与作用域)[标签：让模板产生结构](#标签让模板产生结构)[条件](#条件)[循环](#循环)[过滤器：改变输出](#过滤器改变输出)[数据类型与真假值](#数据类型与真假值)[一个完整的商品摘要](#一个完整的商品摘要)[开始编码前的检查清单](#开始编码前的检查清单)
## Sline 解决什么问题
Sline 是 SHOPLINE 的模板语言。主题文件先写好静态结构，再通过对象和属性插入当前商品、集合、顾客或页面数据。它还提供标签处理条件与循环，并通过过滤器改变输出格式。
一个商品标题的最小输出是：
```
{{ product.title }}
```
这里的 `product` 是对象，`title` 是属性。实际渲染时，SHOPLINE 会把当前商品的数据填入模板。
本节依据[
SHOPLINE Sline 概述：对象、标签和过滤器的角色
](https://developer.shopline.com/docs/sline/sline-overview/)
> **先建立边界：** Sline 服务于 SHOPLINE 主题渲染。SHOPLINE 明确说明开发者不能自行定义新的 Sline 标签和过滤器，应从官方参考中选择平台提供的能力。
## 输出与 HTML 安全
### 默认转义
双花括号会输出数据并转义其中的 HTML 特殊字符：
```
{{ product.description }}
```
这是处理标题、文本设置或顾客输入时更安全的默认方式。
### 明确输出 HTML
三花括号会把内容作为未转义 HTML 输出：
```
{{{ product.description }}}
```
只有在字段本身由 SHOPLINE 以富文本或可信 HTML 形式提供，并且官方对象说明允许这样使用时，才应选择三花括号。不要为了“让标签生效”就把普通输入改成未转义输出。
## 对象、属性与作用域
Sline 对象分为两类：
- **全局对象**可在多种主题模板中访问，例如页面标题一类的全局数据。
- **局部对象**只在创建它的标签或当前模板范围内有效，例如循环中的 `forloop`。
访问属性通常使用点号：
```
{{ product.title }}
{{ product.featured_image }}
```
当 key 来自变量，或者名称不适合点号访问时，可以使用方括号：
```
{{ products[index].title }}
{{ linklists["footer"].links }}
```
资源 handle 是 SHOPLINE 中商品、集合、博客等资源的稳定标识。不要把显示标题当成 handle；如果 handle 改变，依赖旧 handle 的主题引用也需要一起检查。
## 标签：让模板产生结构
标签负责条件、循环、变量或平台提供的专用输出。普通标签有开始与结束，自闭合标签以 `/}}` 结束。
### 条件
```
{{#if customer != nil}}
欢迎回来，{{ customer.name }}
{{#else/}}
登录
{{/if}}
```
Sline 支持 `==`、`!=`、`>`、`<`、`>=`、`<=`，以及 `&&`、`||`。复杂条件可以使用括号明确优先级。
### 循环
```
{{#for product in collection.products}}
- {{ product.title }}
{{/for}}
```
循环内部优先使用当前项目对象，不要假设可以像 Handlebars 一样通过 `../` 回到父级作用域。跨层数据访问是后续迁移时最容易遗漏的差异之一。
## 过滤器：改变输出
过滤器写在管道符 `|` 后，并从左到右依次执行：
```
{{ product.price | money() }}
```
多个过滤器可以串联：
```
{{ product.title | truncate(40) | escape() }}
```
过滤器应该用于轻量的数据格式化。商品选择、权限判断或复杂业务规则仍应由平台数据或应用层处理，而不是塞进主题模板。
## 数据类型与真假值
Sline 支持字符串、数字、布尔值、`nil` 和数组等类型。初学时需要特别注意两点：
1. 空字符串和空数组在 Sline 中可能仍被视为真。
2. 不能直接初始化数组，但可以使用 `split()` 把分隔字符串转换为数组。
因此，检查数组是否有内容时应判断长度：
```
{{#if collection.products | size() > 0}}
找到商品
{{#else/}}
当前集合没有商品
{{/if}}
```
本节依据[
SHOPLINE Sline Basics：数据类型、真假值和运算符
](https://developer.shopline.com/docs/sline/basics/)
## 一个完整的商品摘要
下面的示例把对象、条件、过滤器和默认转义放在一起：
```
{{#if product.featured_image}}
{{#image_tag product.featured_image | image_url(width=720) /}}
{{/if}}
{{ product.title }}
{{ product.price | money() }}
{{#if product.available}}
查看商品
{{#else/}}
暂时售罄
{{/if}}
```
真实项目中，应再次对照当前对象、过滤器和标签参考，确认属性名与参数适用于目标页面。
练习这些表达式时，可把片段粘贴到 [Sline AST Explorer](/sline-ast-explorer/) 查看语法树；工具只检查语法结构，实际数据输出仍需在主题预览中验证。
## 开始编码前的检查清单
- 确认当前文件能访问哪些全局和局部对象。
- 普通文本使用双花括号，只有可信 HTML 才使用三花括号。
- 数组是否为空用 `size()` 判断。
- 过滤器按从左到右的顺序阅读与调试。
- 不依赖自定义标签或过滤器。
- 资源引用使用正确 handle，不使用可能变化的显示名称。
- 每次新增模板逻辑后，同时检查有数据、无数据和未登录状态。
[下一阶段**Sline、Handlebars 与 Liquid 语法对照**
把已经掌握的 Sline 基础放进三种模板语言中比较。
](https://sline.dev/sline-vs-handlebars-vs-liquid/)
官方来源
1. 01[Sline overview](https://developer.shopline.com/docs/sline/sline-overview/)SHOPLINE Developer Center
Sline 的用途、输出方式、标签、过滤器、对象与作用域。
2. 02[Basics](https://developer.shopline.com/docs/sline/basics/)SHOPLINE Developer Center
数据类型、运算符、真假值、资源 handle 与空白控制。
3. 03[Tags](https://developer.shopline.com/docs/sline/tags/)SHOPLINE Developer Center
控制模板逻辑的标签类型与使用方式。
4. 04[Filters](https://developer.shopline.com/docs/sline/filters/)SHOPLINE Developer Center
管道式过滤器及其顺序执行规则。
5. 05[Objects](https://developer.shopline.com/docs/sline/objects/)SHOPLINE Developer Center
主题可访问的数据对象与属性。
## 从语法认识到主题交付
完整路线
1. [01**认识 Sline**
理解对象、标签、过滤器与作用域。
](https://sline.dev/sline-template/)
2. [02**语法对照**
比较 Sline、Handlebars 与 Liquid。
](https://sline.dev/sline-vs-handlebars-vs-liquid/)
3. [03**迁移实战**
将常见模板写法迁移到 Sline。
](https://sline.dev/liquid-handlebars-sline/)
4. [04**主题架构**
对照 Dawn 与 Bottle 的组织方式。
](https://sline.dev/Shopify-Dawn-vs-Shopline-Bottle/)
5. [05**升级 OS 3.0**
规划主题、应用和内容迁移。
](https://sline.dev/shopline-transformation/)
6. [06**CLI 工作流**
完成本地开发、检查与交付。
](https://sline.dev/sline-theme-cli/)
[Sline](/zh-cn/)
面向 SHOPLINE 主题、店面和商品数据的开发者资源与浏览器工具。
## Sline
- [Sline 概览](/zh-cn/)
- [主题 Sections](/section/)
- [AST 浏览器](/sline-ast-explorer/)
## 指南
- [Sline 模板入门](/sline-template/)
- [语法对比](/sline-vs-handlebars-vs-liquid/)
- [迁移实战](/liquid-handlebars-sline/)
- [Dawn 与 Bottle 对比](/Shopify-Dawn-vs-Shopline-Bottle/)
- [OS 3.0 迁移](/shopline-transformation/)
- [主题 CLI](/sline-theme-cli/)
## MCP
- [SHOPLINE Dev MCP](/mcp/)
- [Storefront MCP](/storefront-mcp/)
- [Shopline MCP](/shopline-mcp/)
## 工具
- [SkuSync](/skusync/)
- [SHOPLINE 转 Shopify](/convert-shopline-csv-to-shopify-format/)
- [Shopify 转 SHOPLINE](/convert-shopify-csv-to-shopline-xlsx/)
- [AI 就绪检查器](/ai-checker/)
- [SkuSync 文档](/docs/)
- [Shopline Checker](/shopline-checker/)
- [Shopline Helper](/shopline-helper/)
- [ImgSEO](/imgseo/)
- [ImgSEO 指南](/imgseo-doc/)
## 社区与支持
- [SHOPLINE 开发文档](https://developer.shopline.com/docs/sline/)
- [GitHub](https://github.com/shoplineos/)
- [报告问题](https://github.com/shoplineos/Bottle/issues)
- [联系我们](mailto:hi@sline.dev)
- [SKU.md](https://sku.md)
- [免责声明](/disclaimer/)
## 语言
[English](/)[简体中文](/zh-cn/)[繁體中文](/zh-tw/)[日本語](/ja/)
© 2026 Sline.dev。保留所有权利。