搜索框下有商品，也有词语：Shopify预测搜索怎样组织返回结果

独立站的搜索框下出现一行文字，可能是商品，也可能只是建议继续搜索的词。Shopify的predictiveSearch文档将这两种对象明确分开：按顾客尚未输入完整的词返回匹配资源，同时提供帮助细化搜索的query suggestions。[1] 本篇采用实际文档标示的2026-10版本，解释返回对象，不调用接口或评价真实店铺搜索。

Possible returns将结果展开成articles、collections、pages、products与queries五个列表。前四项分别指向文章、系列、页面与商品对象，最后一项则是相关查询词建议。它们可以共同出现在预测搜索的资料结构中，却不都代表一件可售商品。对搜索内容交接，说明某项来自哪个列表，比将所有行都叫“产品结果”更能保留原意。

资源类型还影响搜索字段的解释。searchableFields用于页面、文章和系列；省略这一项时，文档说这三类按title搜索。商品结果则始终搜索全部商品字段，并忽略该参数。因此，同一参数名并不会同样作用于每一种资源。若只保留“默认搜索标题”，就会把明确的商品例外删去，也容易让商品资料与内容页资料混在一个假想规则里。

结果数量有另一层分配。predictiveSearch给limit列出上限条件，而PredictiveSearchLimitScope定义ALL与EACH。[2] ALL表示跨全部类型合计不超过所给limit，EACH表示每一种类型分别不超过limit。例如，仅作概念说明，假设上限取三：前者讨论各类型合起来的三项范围，后者允许各类分别在三项以内。这不是本文执行的搜索，也不意味着每类一定找足三项；上限与实际命中数量仍有区别。

查询词建议自身又分两种文本表达。SearchQuerySuggestion的text提供普通文本，styledText包含用于高亮匹配部分的HTML标签。[3] 这不是给同一个建议新增第二件商品，而是让同一建议有普通文字和突出匹配处的表达。资料里保留这两个字段，可以解释为什么两段内容看起来不同，所指查询词却仍可能相同。

这些定义共同描绘了预测搜索的组织方式：partial terms触发建议，资源按类型分别返回，限数决定列表之间的分配，文本字段说明词建议如何呈现。它回答的是搜索框输入过程中提供什么信息，没有证明某一建议最终被顾客选中。对内容人员，清楚辨认词、页面与商品，有助于把界面说明写到对应对象上。

三份官方文档首次发布日期均未确认，latest入口在本次实际返回中标示2026-10，不视为永远不变的版本。本文只采用定义、字段与限数枚举，未配置店铺、编写查询或验证结果排序，不提供价格、交易权益、流量及销售效果结论。