讲师中心 微信公众号
AI工具推荐 视频效率加速

如何正确在 YAML 中定义多行字符串以避免格式错误

大枫姑娘_7404

大枫姑娘_7404

发布时间:2026-07-11 14:47:06

|

929人浏览过

|

来源于php中文网

原创

如何正确在 YAML 中定义多行字符串以避免格式错误

YAML 文件中使用三重双引号(""")会导致解析失败,因其不符合 YAML 规范;应改用字面量块标量(|)或折叠块标量(>)来安全表示含换行、特殊字符的长文本。

yaml 文件中使用三重双引号(`"""`)会导致解析失败,因其不符合 yaml 规范;应改用字面量块标量(`|`)或折叠块标量(`>`)来安全表示含换行、特殊字符的长文本。

YAML 对字符串格式有严格语法规则,不支持 Python 风格的三重双引号字符串("""...""")。您原始配置中 PROMPT_SUMMARY: """...""" 的写法是非法的——YAML 解析器会将其误判为两个连续的标量(空字符串 "" 后紧跟另一个 " 开头的字符串),从而抛出类似 expected <block end>, but found '<scalar>' 的语法错误。

✅ 正确做法:使用字面量块标量(|)

当需要保留原始换行、缩进和所有字符(包括 \n 字面量本身)时,应使用 |(竖线)开头的字面量块:

WORKFLOW:
  EXTRACT_SUMMARIZATION:
    PROMPT_SUMMARY: |
      Extracting the timestamps of the goals scored by players in a football match using the commentator's description.
      The structure of input is: 
      timestamp => text
      timestamp => text
      timestamp => text
      timestamp => text
      The output only consists of timestamps and does not include any text.
      Example:
      Input:
      0:01 => [Applause]
      0:04 => Welcome, ladies and gentlemen, to the match between Liverpool and Chelsea.
      0:14 => Silva has scored, and the score is 1-0 in favor of Liverpool.
      0:20 => So, there has been a foul committed by a Liverpool player.
      0:25 => The referee has blown the whistle to end the first half.
      0:30 => Chelsea has equalized through Ch.
      0:45 => Tr has put Chelsea in the lead.
      0:50 => So, the match has...
      0:55 => ended, and the victory goes to Chelsea.
      Output: 0:14, 0:30, 0:45
      This is an incorrect format of output: 
      0:14 => Silva has scored, and the score is 1-0 in favor of Liverpool.
      0:45 => Tr has put Chelsea in the lead.
      This is another incorrect format of output:
      0:01 => [Applause]
      0:04 => 0:14 => 0:25 =>
      Do it for the following text:
      Input:
      {}
      Output:

⚠️ 注意事项:

  • | 后的换行会被自动保留,首行换行符默认被丢弃(可通过 |- 去除末尾空白行,|+ 保留末尾换行);
  • 块内无需转义 \n —— 换行即换行,\n 字符串将被原样视为反斜杠 + n;
  • 若需在提示中插入变量占位符(如 {}),直接书写即可,YAML 不做预处理,由上层程序(如 Python 的 .format() 或 f-string)动态替换;
  • 缩进必须一致(推荐 2 或 4 空格),且块内容需比 | 所在行更深层级缩进,否则解析失败。

? 替代方案:折叠块标量(>)

若希望将多行自动折叠为单行(用空格连接,保留段落间换行),可用 >:

PROMPT_SUMMARY: >
  Extracting timestamps...  
  The structure is: timestamp => text  
  Output only timestamps.  
  Example: Input: 0:01 => ..., 0:14 => ... Output: 0:14, 0:30

其效果等价于 "Extracting timestamps... The structure is: ... Output: 0:14, 0:30"(内部换行转为空格,段落间保留 \n)。

? 错误避坑清单

  • ❌ 禁用 """..."""、'''''' 或连续双引号拼接;
  • ❌ 不要在双引号字符串中手动写 \n 期望换行(YAML 会将其当作字面字符);
  • ❌ 避免混合空格与 Tab 缩进(YAML 要求纯空格);
  • ✅ 建议使用 ruamel.yaml(而非在线校验器)本地验证,避免隐私泄露与过时解析器误报。

正确使用 | 或 > 后,您的 config.yml 即可被主流 YAML 解析器(PyYAML、ruamel.yaml、GitHub Actions 等)无误加载,确保 LLM 提示工程稳定运行。

热门AI工具

更多
UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

相关专题

更多
js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1778

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2804

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

6144

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

5869

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

7494

2024.03.22

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

11134

2024.04.29

go语言字符串相关教程
go语言字符串相关教程

本专题整合了go语言字符串相关教程,阅读专题下面的文章了解更多详细内容。

5719

2025.07.29

c++字符串相关教程
c++字符串相关教程

本专题整合了c++字符串相关教程,阅读专题下面的文章了解更多详细内容。

6267

2025.08.07

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

60

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn