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

如何正确在 YAML 中定义多行字符串(含换行与特殊字符)

大枫姑娘_7404

大枫姑娘_7404

发布时间:2026-07-11 14:44:03

|

1008人浏览过

|

来源于php中文网

原创

如何正确在 YAML 中定义多行字符串(含换行与特殊字符)

YAML 文件中使用三重双引号(""")定义长字符串会导致解析错误;正确方式是采用字面量块标量(|)保留换行,或使用折叠块标量(>)自动合并换行,避免非法嵌套引号和转义混乱。

yaml 文件中使用三重双引号(`"""`)定义长字符串会导致解析错误;正确方式是采用字面量块标量(`|`)保留换行,或使用折叠块标量(`>`)自动合并换行,避免非法嵌套引号和转义混乱。

YAML 对字符串格式有严格语法规则,尤其在处理多行、含换行符(\n)或特殊符号的长文本时,常见错误是误用 Python 风格的三重引号("""...""")。YAML 不支持类似 Python 的 triple-quoted 字符串拼接或隐式换行,直接写 """...""" 会被解析器视为语法冲突——因为 "" 已是一个空字符串值,后续紧接的 " 会被误判为非法标量起始。

✅ 正确做法:使用 字面量块标量(Literal Block Scalar),以 | 开头,保留原始换行与空白:

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(即 YAML 解析后字符串含真实换行),无需写 \n;
  • 若需去除首尾空行,可加 |-(剪裁末尾换行)或 |+(保留末尾换行);
  • 字面量块中 不解析转义序列(如 \n、\t 会原样保留为文字),因此不要在 | 块内写 \n;
  • 如需自动将换行折叠为空格(适合段落文本),改用折叠块标量 >,例如 PROMPT: >;
  • 避免使用在线 YAML 校验工具(如 yaml-validator),它们常基于过时解析器,反馈不可靠;推荐本地使用 ruamel.yaml 或 yamllint 进行验证;
  • 文件扩展名应统一为 .yaml(官方推荐),而非 .yml(虽被广泛接受,但非标准)。

? 小技巧:若字符串中需包含 | 或 > 字符本身,只需确保其不出现在行首(缩进即可),YAML 会正常识别——字面量块标量天然支持引号、尖括号等任意字符,无需额外转义。

热门AI工具

更多
超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

WorkBuddy

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

DeepSeek

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

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

豆包大模型

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

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

相关专题

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

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

1798

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

字符串介绍
字符串介绍

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

5889

2023.11.24

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

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

7514

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