YAML文件格式-字符串

在Spring Boot的YAML配置文件中，加引号（""或''）与不加引号的区别主要体现在特殊字符处理、转义规则和YAML语法解析上。以下是详细说明，结合你提供的配置例子（publicKeyStr和license）展开：

一、YAML字符串的三种表示方式

YAML中的字符串有三种常见写法，每种写法的解析逻辑和适用场景不同：

写法	示例	特点
裸字符串	app.name: myapp	无引号，适合无特殊字符的简单字符串（如字母、数字、下划线组合）。
单引号	app.desc: 'Hello, World!'	保留字符串原样，不解析转义字符（如\n会被当作\n而非换行）。
双引号	app.desc: "Hello\nWorld"	解析转义字符（如\n表示换行），保留特殊字符（如冒号、逗号、换行）。

二、加引号与不加引号的核心区别

1. 特殊字符的处理

YAML中部分字符（如:、,、#、|、>、换行符等）具有语法含义（如:用于分隔键值对，|用于保留换行）。若字符串包含这些字符，必须用引号括起来，否则YAML会解析错误或误解语义。

例子1：publicKeyStr中的换行符
你的publicKeyStr包含PEM格式的公钥，其中有换行符（如-----BEGIN PUBLIC KEY-----后面的换行）。若不加引号，YAML会将换行符视为配置项的分隔符，导致解析失败（如认为换行后的内容是新的配置键）。
用双引号括起来后，换行符会被保留，解析后的字符串是完整的PEM格式（包含换行），后续加载公钥（如KeyFactory.generatePublic）时才能正确识别。

例子2：license中的特殊字符
你的license值包含|（竖线）、+（加号）、/（斜杠）等字符。|在YAML中是保留换行的标记（如key: | ...表示保留后续行的换行），若不加引号，YAML会将|解析为语法标记，导致license的值被错误截断（如只保留|前面的部分）。
用双引号括起来后，|会被当作普通字符处理，解析后的license值完整无误。

2. 转义字符的解析

• 裸字符串/单引号：不解析转义字符（如\n会被当作\n字符串，而非换行）。
• 双引号：解析转义字符（如\n表示换行，\t表示制表符，\"表示双引号本身）。

例子：

• 若配置为app.desc: "Hello\nWorld"，解析后的值是Hello（换行）World。
• 若配置为app.desc: 'Hello\nWorld'或app.desc: Hello\nWorld，解析后的值是Hello\nWorld（保留\n字符串）。

3. 布尔值/数字的区分

若字符串的值是布尔值（true/false）、数字（123/3.14）或null，需要当作字符串处理时，必须用引号括起来。否则YAML会将其解析为对应的数据类型，而非字符串。

例子：

• 若配置为app.enabled: true，解析后是布尔值true。
• 若配置为app.enabled: "true"，解析后是字符串"true"。

三、你的配置例子为什么必须加引号？

看你的publicKeyStr和license配置：

app:
publicKeyStr: "-----BEGIN PUBLIC KEY-----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAnJS3y51f3rZhaCGxagoA
HqLpijapZu/onms57Jk70oh7ZzFWWFkMDGsspTN7s6Fa5EH0W0o5mlmEe9YJSGzX
443PEWWrrU8fOneAXq1oIYyMJMngASGIBpd/TvalOenkP3/eB8ppBPgQ+z9BTWmK
2aQWSHgNH8g41a+E0ZMXvdQEBXL7jWcRkMk6xooATnqtq1tvHwun3zd3XGlLn5Xn
iH3Ew/MVQPzba98JccOSSCLeEmGOWhIbt976EQZjqPhHSJdeeRxzZOLH5qA4mDRu
gayvCLS8yKIe2AqdioOJ8VGk5zxAMYBr6X2A/mmfx82NKuq+t/JuIv6dC0bDMKkt
RwIDAQAB
-----END PUBLIC KEY-----"
license: "9298f31e-8dbb-3bb6-b2a5-8f8a6fd60352|2026-07-22|KvD+g/1mNSIFKd+Cnod37bMZo/93jVmIvFPMvwmNDqZOolXCkGkgoNiyLohFYh2vPERLjVBqgO7FVn8wqrEEfWP7/4xmV16dJDWcy8HidfWLGTEd9l0urVPtRc3wYheWjqRn1QrtX29cCZB9wFeD3/dcDCmOLP6LKvv68Xcb8zq9FmNBXHNSTrm3/zIyrKZGEdXParwJ2cEiJWZFgBpobfBqIW4fxvvvk0bkPeK1mzr9oJl2AWEy2xUto4smo6fTxigJNVsRUmQLBohocz97Frq87ayX6m+c4s06jQmMl3PgjLb4JcHlnOMF8bma6OUqPbaOQsduThYKV2dAjyD++g=="

1. publicKeyStr必须加双引号的原因

• 包含换行符：PEM格式的公钥需要保留换行符（如-----BEGIN PUBLIC KEY-----与后续密钥内容之间的换行），否则KeyFactory无法正确解析公钥（会提示“无效的密钥格式”）。
• 包含特殊字符：-----BEGIN PUBLIC KEY-----中的-是YAML中的普通字符，但换行符是语法分隔符，必须用双引号括起来才能保留。

2. license必须加双引号的原因

• 包含|字符：license中的|是YAML中的保留换行标记（如key: | ...表示保留后续行的换行），若不加引号，YAML会将|解析为语法标记，导致license的值被错误截断（如只保留|前面的9298f31e-8dbb-3bb6-b2a5-8f8a6fd60352）。
• 包含+//字符：这些字符在YAML中是普通字符，但为了避免解析歧义（如+可能被当作数字的正号），用双引号括起来更安全。

四、总结：什么时候需要加引号？

在Spring Boot YAML配置中，以下情况必须用引号括起来：

1. 字符串包含特殊字符：如:、,、#、|、>、换行符、空格（开头或结尾）等。
2. 字符串需要保留转义字符：如\n（换行）、\t（制表符）等，需用双引号。
3. 字符串需被当作字符串处理：如布尔值（"true"）、数字（"123"）、null（"null"）等。
4. 字符串包含PEM格式、JSON、XML等结构化内容：这些内容通常包含换行符或特殊字符，必须用双引号保留格式。

五、最佳实践

• 对于简单字符串（如app.name: myapp），可以不加引号。
• 对于包含特殊字符、转义字符或结构化内容的字符串（如你的publicKeyStr和license），优先使用双引号（因为双引号支持转义，能正确保留特殊字符）。
• 避免使用单引号（除非不需要转义，如app.desc: 'Hello, World!'），因为单引号不解析转义，容易导致预期外的结果。

结论：你的配置中的publicKeyStr和license必须用双引号括起来，否则会导致YAML解析错误或配置值无效（如公钥加载失败、license值截断）。