YAML“没换行”本质是缩进混乱导致解析器提前终止或跳过嵌套块，而非换行符问题；解析器只认空格数量与层级对齐，冒号后缺空格、|后未换行、detectIndentation启用混用Tab/空格等均会引发此现象。
YAML 文件没换行，本质是缩进混乱或格式化没生效，不是换行符本身的问题——YAML 解析器根本不关心 LF 还是 CRLF，只认空格数量和层级对齐。
为什么 YAML 看起来“没换行”？
这不是换行符缺失，而是缩进错乱导致解析器提前终止或跳过嵌套块。常见现象包括：
- 保存后整段内容挤在一行（如
server: {port: 8080, mode: release}），其实是冒号后缺空格 + 缩进全崩了 - 多行字符串（
description: |）不换行，往往因为|后少了换行，或下一行缩进量不对 - 用
Shift+Alt+F手动格式化无效，说明redhat.vscode-yaml没被设为默认 formatter，或editor.formatOnSave被语言级配置覆盖
必须关掉 editor.detectIndentation
这个设置是 YAML 缩进灾难的隐形推手。VS Code 默认开启它，会读取文件第一行缩进“猜”风格；一旦遇到混用 Tab 和空格的老文件，整个工作区就跟着切到 Tab 模式，后续所有新写内容都继承错误。
- 在项目根目录的
.vscode/settings.json中强制关闭："editor.detectIndentation": false - 同时锁定空格插入：
"editor.insertSpaces": true和"editor.tabSize": 2（K8s/Ansible 推荐 2，Spring Boot 常用 2） - 别配在用户设置里——不同项目缩进规范可能不同，工作区级才可靠
如何验证空格/TAB 是否真的统一？
不显示空白字符，一切格式化都是假动作。
- 按
Ctrl+Shift+8（macOS 是Cmd+Shift+8）临时显示所有空白：空格是·，Tab 是→ - 同级键（如
port:、host:）缩进位置必须出现完全相同的符号序列，不能有的行是··，有的行是→ - 如果发现混用，右键选择
Convert Indentation to Spaces，再保存——别手动删 Tab，容易漏
冒号后不加空格 = 直接报错
YAML 解析器把 port:8080 当作一个 key 名叫 port:8080，而不是 port 的值。这不是警告，是硬性语法失败。
- 所有
:后必须跟至少一个空格，包括映射、内联序列、锚点定义（&db后也要空格） - 多行字面量（
|或>）后必须换行，且下一行缩进要严格等于其父级键的缩进量 + 1 个空格（不是更多） - 用 Red Hat 插件时，把鼠标悬停在冒号上，如果没提示“Expected a space after ‘:’”，说明这行大概率已合规
最常被忽略的点：格式化只修“形”，不救“意”。比如 image: nginx:latest 缩进再对，如果写成 image:nginx:latest（冒号连写），插件也救不了——它只管结构，不管语义是否符合 K8s 或 Docker 规范。
