微信公众号模板消息是服务端向用户主动推送通知的重要能力，但在实际业务中，我们经常需要在同一条消息里展示多行内容，比如收货地址、商品清单或操作步骤。由于模板消息的字段在微信客户端里默认以单行文本渲染，直接拼接字符串往往导致内容挤在一起，用户体验不佳。要解决这个问题，必须先理解微信模板消息的数据结构以及客户端对特殊字符的处理逻辑。
微信模板消息通过行业模板定义固定字段，每个字段在调用接口时由开发者填入value。这些value在传输过程中是普通JSON字符串，微信服务器原样下发给客户端，由客户端按模板样式绘制。很多开发者误以为模板消息不支持任何换行，其实只要在value中放入被客户端识别的换行控制符，就能实现参数内的换行效果。不过不同系统、不同微信版本对控制符的解析并不完全一致，这也是方案选型时的主要风险点。
从协议层面看，模板消息并没有像富文本那样提供换行标签，因此所有换行都依赖于字符层面的控制序列。了解这一点后，我们就可以从字符串构造、模板设计、以及消息跳转三个维度来组织实现方案。下面分别展开说明，并给出可运行的代码示例与对比分析。
方案一：在参数值中插入换行转义符
最直观的做法是在拼接模板参数时，于需要换行的位置加入换行符。在绝大多数后台语言里，我们可以直接使用n或者rn作为换行标记。微信安卓客户端通常能正确识别n并断行，而iOS旧版本有时要求rn才能稳定换行，因此实践中推荐优先使用rn以提升兼容性。
下面以PHP为例，演示如何在订单通知模板的备注字段中换行展示地址与电话。注意JSON编码时rn会被正确序列化为转义序列，微信服务器收到后下发给客户端，客户端按控制符断行。这种方式改动最小，不需要调整已申请的模板。
<?php
$address = "北京市海淀区中关村大街1号";
$phone = "13800001111";
// 使用rn提升iOS兼容性
$remarkValue = "收货信息：rn" . $address . "rn联系电话：" . $phone;
$template = array(
"touser" => "OPENID_EXAMPLE",
"template_id" => "TEMPLATE_ID_EXAMPLE",
"data" => array(
"first" => array("value" => "您的订单已发货"),
"remark" => array("value" => $remarkValue, "color" => "#173177")
)
);
echo json_encode($template, JSON_UNESCAPED_UNICODE);
?>
该方案的优点是零模板成本、立即生效；缺点是所有换行都挤在一个字段里，若业务后续要在模板后台配置中预览，可读性较差。另外部分第三方微信SDK在拼接时会过滤控制字符，需要确认SDK未做trim或正则清理。如果字段本身有字数上限，插入rn也占用长度，超长会被微信截断。
从维护角度，建议把换行拼接逻辑封装成工具函数，统一处理不同系统的兼容。例如提供一个buildMultiline方法，内部根据运行环境或配置决定使用n还是rn，避免散落在业务代码里难以排查。
方案二：拆分模板字段实现结构化换行
当模板尚未申请或可以修改时，更稳妥的思路是把原本一个长字段拆成多个独立字段。比如把“商品明细”拆为“商品1”“商品2”“商品3”，每个字段在模板中自然占一行。这样不需要任何控制符，各端渲染稳定，且运营在模板后台能清晰看到每行含义。
这种方案要求我们在微信公众平台选用或申请支持多行的行业模板，或者在自定义模板里显式添加多个参数位。调用时分别填充，微信按模板布局逐行展示。以下为Java构造多字段数据的示例，展示如何将订单内容分行传入。
import com.alibaba.fastjson.JSONObject;
public class TemplateDemo {
public static void main(String[] args) {
JSONObject data = new JSONObject();
data.put("first", JSONObject.parseObject("{"value":"订单支付成功"}"));
data.put("keyword1", JSONObject.parseObject("{"value":"iPhone 15"}"));
data.put("keyword2", JSONObject.parseObject("{"value":"USB-C 数据线 x2"}"));
data.put("keyword3", JSONObject.parseObject("{"value":"2999 元"}"));
data.put("remark", JSONObject.parseObject("{"value":"感谢您的购买"}"));
JSONObject body = new JSONObject();
body.put("touser", "OPENID_EXAMPLE");
body.put("template_id", "TEMPLATE_ID_EXAMPLE");
body.put("data", data);
System.out.println(body.toJSONString());
}
}
拆分字段的好处是渲染最可控，不会因为控制符被过滤而失效，也方便在模板中给每行配不同颜色。但代价是模板灵活性下降：字段数量固定，若商品超过三个就得放弃或折叠。此外每次调整行数都要重新走模板申请流程，周期较长。
对于内容行数不固定的场景，可以结合方案一，在最后一个“备注”字段里用rn补充剩余信息，用固定字段保证核心数据稳定，用动态字段兜底，兼顾兼容与灵活。
方案三：借助跳转与摘要规避换行限制
如果模板消息本身实在无法容纳多行细节，还可以把完整多行内容放到点击消息后打开的网页或小程序页面中。模板消息仅承担“提示+摘要”作用，详细参数在小程序或H5里自然换行排版。这是架构层面的规避方案，适合电商订单、物流跟踪等强详情需求。
实现时，在模板消息的url或miniprogram字段配置落地页，模板的remark只写一句话摘要。用户点击后进入详情页，那里可以使用正常的HTML或WXML换行标签，完全不受模板限制。下面给出配置跳转的Python示例。
import json
template = {
"touser": "OPENID_EXAMPLE",
"template_id": "TEMPLATE_ID_EXAMPLE",
"url": "https://ipipp.com/order/detail?id=123",
"data": {
"first": {"value": "您的快递已签收"},
"keyword1": {"value": "SF1234567890"},
"remark": {"value": "点击查看签收照片与配送信息"}
}
}
print(json.dumps(template, ensure_ascii=False))
该方案把换行压力转移到了网页端，模板消息永远整洁，也不会触发字数截断。但它依赖用户主动点击，且必须维护额外页面。如果业务要求消息本体就要可读，此方案只能作为补充。
综合来看，换行显示并非微信模板消息的禁区，核心是根据字段稳定性、端兼容与维护成本做权衡。固定少行用拆字段，动态多行用控制符，超长细节用跳转，三者可叠加。上线前务必在安卓与iOS真机验证，避免控制符被SDK误清。