sed用i在匹配行前、a在匹配行后插入文本，二者均需换行且支持正则；多行或特殊字符内容宜用r命令读取文件；位置错误常因地址匹配不精准，应检查缩进、空格及实际行结构。
sed 在匹配行前插入文本：用 i 命令
要实现在关键词所在行的「上方」插入新内容，核心是 i（insert）命令。它必须紧跟在地址匹配后，且换行符不能省略——这是最常出错的地方。
比如想在包含 listen 8080 的行前面插入注释：
sed '/listen 8080/i # This is a custom port' nginx.conf
注意：i 后必须紧接反斜杠和换行，再写要插入的内容；不能写成 i # comment 一行，否则会报错或静默失败。
-
/pattern/i中的pattern支持正则，如/^ *server {/i可匹配缩进后的 server 块起始行 - 如果文件有多处匹配，
i会对每一处都生效 - 使用
-i原地修改时，先确认命令逻辑正确，避免误改
sed 在匹配行后插入文本：用 a 命令
a（append）负责在匹配行「下方」追加内容，行为与 i 对称，但同样要求换行格式严格。
例如在 location / { 行后面加一个子配置：
sed '/location //a
proxy_set_header X-Real-IP $remote_addr;' nginx.conf
注意空格缩进会被原样保留，所以如果目标配置需要对齐，得手动加好空格或制表符。
-
a和i都不支持直接拼接变量（如sed "/foo/a$var"），需用双引号 + 转义配合bash变量展开 - 若匹配行是文件末尾，
a插入的内容会成为新末行，行为符合预期 - 匹配失败时，整条命令无输出，容易误以为“没生效”，建议先用
grep确认 pattern 是否存在
处理多行插入或含特殊字符的内容
当要插入的文本本身含换行、单引号、斜杠等，直接写在 i 或 a 后面会破坏语法。此时应优先考虑用 r（read）命令读取外部文件，或改用 awk。
例如插入多行配置块：
printf '# upstream
upstream backend {
server 127.0.0.1:9000;
}' > /tmp/insert.conf
sed '/http {/r /tmp/insert.conf' nginx.conf
r 命令会在匹配行之后读入整个文件，无需处理转义，也天然支持多行。
- 不能用
r实现「匹配行之前插入」，它只支持追加（after） - 若必须用
sed插入含单引号的字符串，可混用单双引号：sed "/foo/a\ echo 'it\'s working'"
-
sed -e '/p1/i' -e 'line1' -e '/p2/i' -e 'line2'这种分段写法可行，但可读性差，不推荐用于复杂场景
为什么有时插入位置不对？检查地址范围和空行干扰
常见问题不是命令写错，而是匹配地址没对上。比如 /server {/i... 看似匹配，但实际配置中可能是 server { 前有空格、注释，或用了大括号换行写法（server{）。
更稳妥的做法是放宽匹配，或分步处理：
- 用
/^[[:space:]]*server[[:space:]]*{/匹配任意缩进+空格的 server 块起始 - 用
/server.*{/匹配在同一行的server ... { - 插入前先用
sed -n '/pattern/{=;p;}' file查看匹配行号和原始内容，确认是否真被选中 - 空行或注释行可能让视觉判断失准，建议搭配
cat -n查看真实行结构
真正麻烦的从来不是怎么写那条 sed 命令，而是你怎么确定它正在操作你心里想的那行。
