飞书机器人消息换行终极指南告别\n拥抱富文本JSON最近在技术社群里看到不少开发者抱怨为什么在飞书机器人消息里用\n换行总是失效这确实是个常见痛点。作为一位经历过同样困扰的开发者我完全理解这种挫败感——明明在大多数编程语言和API中\n都是标准的换行符怎么到了飞书这里就不灵了1. 为什么\n在飞书机器人消息中无效飞书的消息推送系统设计有其特殊性。与普通文本消息不同飞书机器人API采用了更结构化的消息格式体系。当你直接发送包含\n的文本时飞书服务器并不会像我们预期的那样解析这个转义字符为换行符。根本原因在于飞书的消息类型划分纯文本消息最简单的消息格式但功能有限富文本消息支持复杂格式和交互元素卡片消息更丰富的UI组件和交互能力\n失效的问题主要出现在纯文本消息场景中。飞书选择不解析纯文本中的转义字符这看似是个限制实则是为了保持API的一致性和安全性。2. 富文本消息解决换行问题的正确姿势富文本消息类型(msg_type: post)才是飞书机器人消息格式化的正确解决方案。这种消息格式使用JSON结构天然支持内容分段和复杂格式。2.1 富文本消息的基本结构一个典型的富文本消息JSON如下{ msg_type: post, content: { post: { zh_cn: { title: 项目更新通知, content: [ [ {tag: text, text: 第一行内容}, {tag: a, text: 超链接, href: https://example.com} ], [ {tag: text, text: 第二行内容} ] ] } } } }关键点解析content数组的每个子数组代表一行每行可以包含多个元素文本、链接、提及等行与行之间会自动换行无需任何转义字符2.2 动态构建富文本消息的代码示例手动拼接JSON容易出错下面是一个更可靠的构建方法Python示例def build_lark_post_message(title, lines): message { msg_type: post, content: { post: { zh_cn: { title: title, content: [] } } } } for line in lines: message_line [] if isinstance(line, str): message_line.append({tag: text, text: line}) else: for element in line: if element[type] text: message_line.append({tag: text, text: element[content]}) elif element[type] link: message_line.append({tag: a, text: element[text], href: element[href]}) # 可以扩展其他元素类型 message[content][post][zh_cn][content].append(message_line) return message3. 高级技巧与常见问题解决3.1 特殊字符转义处理当消息内容包含JSON特殊字符时需要特别注意转义import json text_content 这是一段包含引号和\\反斜杠的内容 escaped_text json.dumps(text_content)[1:-1] # 移除外层的引号 # 使用escaped_text构建消息3.2 混合内容行的构建富文本的强大之处在于可以在同一行混合多种内容[ {tag: text, text: 当前状态: }, {tag: text, text: 成功, style: {color: green}}, {tag: text, text: | 时间: }, {tag: text, text: 2023-07-20 14:30, style: {bold: true}} ]3.3 性能优化建议对于高频发送的场景可以考虑预构建消息模板使用字符串缓存减少JSON解析开销批量发送多条消息4. 实战构建一个完整的通知系统让我们把这些知识整合到一个实际例子中——构建一个项目部署通知系统import requests import json from datetime import datetime def send_lark_notification(webhook_url, project_name, status, logs): # 准备消息内容 title f{project_name} 部署通知 time_str datetime.now().strftime(%Y-%m-%d %H:%M:%S) status_style {color: green if status success else red} lines [ [{type: text, content: 部署结果: }, {type: text, content: status.upper(), style: status_style}], [{type: text, content: f时间: {time_str}}], [{type: text, content: 日志摘要:}] ] # 添加日志内容每行作为单独段落 for log in logs.split(\n): lines.append([{type: text, content: log}]) # 构建并发送消息 message build_lark_post_message(title, lines) response requests.post(webhook_url, jsonmessage) return response.status_code 200这个例子展示了如何动态构建带格式的消息内容根据状态改变文本颜色正确处理多行日志内容发送到飞书机器人webhook
别再傻傻用\n了！飞书机器人消息换行，用这个富文本JSON格式一次搞定
飞书机器人消息换行终极指南告别\n拥抱富文本JSON最近在技术社群里看到不少开发者抱怨为什么在飞书机器人消息里用\n换行总是失效这确实是个常见痛点。作为一位经历过同样困扰的开发者我完全理解这种挫败感——明明在大多数编程语言和API中\n都是标准的换行符怎么到了飞书这里就不灵了1. 为什么\n在飞书机器人消息中无效飞书的消息推送系统设计有其特殊性。与普通文本消息不同飞书机器人API采用了更结构化的消息格式体系。当你直接发送包含\n的文本时飞书服务器并不会像我们预期的那样解析这个转义字符为换行符。根本原因在于飞书的消息类型划分纯文本消息最简单的消息格式但功能有限富文本消息支持复杂格式和交互元素卡片消息更丰富的UI组件和交互能力\n失效的问题主要出现在纯文本消息场景中。飞书选择不解析纯文本中的转义字符这看似是个限制实则是为了保持API的一致性和安全性。2. 富文本消息解决换行问题的正确姿势富文本消息类型(msg_type: post)才是飞书机器人消息格式化的正确解决方案。这种消息格式使用JSON结构天然支持内容分段和复杂格式。2.1 富文本消息的基本结构一个典型的富文本消息JSON如下{ msg_type: post, content: { post: { zh_cn: { title: 项目更新通知, content: [ [ {tag: text, text: 第一行内容}, {tag: a, text: 超链接, href: https://example.com} ], [ {tag: text, text: 第二行内容} ] ] } } } }关键点解析content数组的每个子数组代表一行每行可以包含多个元素文本、链接、提及等行与行之间会自动换行无需任何转义字符2.2 动态构建富文本消息的代码示例手动拼接JSON容易出错下面是一个更可靠的构建方法Python示例def build_lark_post_message(title, lines): message { msg_type: post, content: { post: { zh_cn: { title: title, content: [] } } } } for line in lines: message_line [] if isinstance(line, str): message_line.append({tag: text, text: line}) else: for element in line: if element[type] text: message_line.append({tag: text, text: element[content]}) elif element[type] link: message_line.append({tag: a, text: element[text], href: element[href]}) # 可以扩展其他元素类型 message[content][post][zh_cn][content].append(message_line) return message3. 高级技巧与常见问题解决3.1 特殊字符转义处理当消息内容包含JSON特殊字符时需要特别注意转义import json text_content 这是一段包含引号和\\反斜杠的内容 escaped_text json.dumps(text_content)[1:-1] # 移除外层的引号 # 使用escaped_text构建消息3.2 混合内容行的构建富文本的强大之处在于可以在同一行混合多种内容[ {tag: text, text: 当前状态: }, {tag: text, text: 成功, style: {color: green}}, {tag: text, text: | 时间: }, {tag: text, text: 2023-07-20 14:30, style: {bold: true}} ]3.3 性能优化建议对于高频发送的场景可以考虑预构建消息模板使用字符串缓存减少JSON解析开销批量发送多条消息4. 实战构建一个完整的通知系统让我们把这些知识整合到一个实际例子中——构建一个项目部署通知系统import requests import json from datetime import datetime def send_lark_notification(webhook_url, project_name, status, logs): # 准备消息内容 title f{project_name} 部署通知 time_str datetime.now().strftime(%Y-%m-%d %H:%M:%S) status_style {color: green if status success else red} lines [ [{type: text, content: 部署结果: }, {type: text, content: status.upper(), style: status_style}], [{type: text, content: f时间: {time_str}}], [{type: text, content: 日志摘要:}] ] # 添加日志内容每行作为单独段落 for log in logs.split(\n): lines.append([{type: text, content: log}]) # 构建并发送消息 message build_lark_post_message(title, lines) response requests.post(webhook_url, jsonmessage) return response.status_code 200这个例子展示了如何动态构建带格式的消息内容根据状态改变文本颜色正确处理多行日志内容发送到飞书机器人webhook
