使用echo配合patch命令执行失败的问题排查

遇到这种嵌入patch失败的情况，大概率是因为你用echo处理diff内容时，破坏了diff的原始格式——毕竟diff里有大量换行、特殊符号（比如!、$、反斜杠），echo默认会转义或者丢失这些关键字符，导致patch拿到的内容和你手动执行时的完全不一样。

给你几个靠谱的解决方案，按推荐程度排序：

1. 用Here-Document直接传递diff给patch（最推荐） #

这是嵌入diff到脚本里最稳妥的方式，Here-Document（简称heredoc）会完整保留diff的所有格式和特殊字符，不需要任何转义操作：

#!/bin/bash

# 用-p1参数适配git生成的diff（如果是普通diff可以改成-p0）
patch -p1 << 'EOF'
# 把你的完整diff内容粘贴在这里，比如：
diff --git a/src/main.c b/src/main.c
index 8a7b6c..d5e4f3 100644
--- a/src/main.c
+++ b/src/main.c
@@ -42,7 +42,7 @@ int main() {
     // 原来的代码
     printf("Hello World!\n");
-    return 0;
+    return EXIT_SUCCESS;
 }
EOF

注意这里的'EOF'要用单引号括起来，这样bash不会解析heredoc内部的变量或者特殊符号，完全还原你的diff内容。如果你的diff里确实需要引用脚本变量，去掉单引号即可，但一般patch场景不需要这么做。

2. 用Heredoc写入临时文件再执行patch #

如果你的逻辑需要先把diff存成文件再patch，同样用heredoc来写文件，避免echo的坑：

#!/bin/bash

# 创建临时diff文件，保留原始格式
cat > /tmp/temp_patch.diff << 'EOF'
# 你的diff内容
diff --git a/src/main.c b/src/main.c
index 8a7b6c..d5e4f3 100644
--- a/src/main.c
+++ b/src/main.c
@@ -42,7 +42,7 @@ int main() {
     // 原来的代码
     printf("Hello World!\n");
-    return 0;
+    return EXIT_SUCCESS;
 }
EOF

# 执行patch
patch -p1 < /tmp/temp_patch.diff

# 清理临时文件
rm /tmp/temp_patch.diff

之前用echo写文件失败，是因为echo会自动处理换行和特殊字符，比如把多行内容变成一行，或者解析!这类符号，导致diff结构损坏。用heredoc写文件就完全不存在这个问题。

3. 用单引号包裹diff字符串再传递 #

如果你非要把diff作为字符串变量嵌入脚本，一定要用单引号包裹整个diff，然后用printf输出（比echo更可靠）：

#!/bin/bash

# 用单引号包裹diff，保留所有格式和特殊字符
MY_PATCH='diff --git a/src/main.c b/src/main.c
index 8a7b6c..d5e4f3 100644
--- a/src/main.c
+++ b/src/main.c
@@ -42,7 +42,7 @@ int main() {
     // 原来的代码
     printf("Hello World!\n");
-    return 0;
+    return EXIT_SUCCESS;
 }'

# 用printf输出diff并传给patch，避免echo的额外换行问题
printf '%s' "$MY_PATCH" | patch -p1

这里用printf而不是echo，是因为某些版本的echo会在输出末尾自动添加换行，可能破坏diff的完整性。

额外注意事项 #

• 确认patch命令的-p参数正确：如果是git diff生成的补丁，一般用-p1去掉路径前的a/或b/前缀；如果是普通的diff命令生成的补丁，可能需要用-p0。
• 脚本执行时的工作目录：如果脚本可能在任意位置运行，最好在patch前切换到目标文件所在的目录，或者在diff里使用绝对路径。
• 检查diff完整性：嵌入时不要不小心截断了diff的内容，尤其是开头的diff --git行和每个hunk的@@ ... @@标识行，这些是patch识别补丁的关键。

内容的提问来源于stack exchange，提问作者Sean Walton