我会用一个awk脚本来做到这一点:

BEGIN {i=0}
(i==0) && /#include/ {print "#include \"newfile.h\""; i=1}
{print $0}    
END {}

然后用awk运行它:

awk -f awkscript headerfile.h > headerfilenew.h

可能有点草率，我是新手。

以下是许多有用的现有答案的概述，并附有解释:

这里的例子使用了一个简化的用例:只在第一个匹配的行中将单词'foo'替换为'bar'。 由于使用ANSI c引号字符串($'…')来提供示例输入行，bash、ksh或zsh被假定为shell。

---

GNU仅适用:

Ben Hoffstein的回答告诉我们，GNU为sed提供了POSIX规范的扩展，它允许以下2-address形式:0，/re/ (re在这里表示任意正则表达式)。

0，/re/也允许正则表达式匹配第一行。换句话说:这样的地址将创建一个范围，从第一行到匹配re的行，无论re出现在第一行还是任何后续行。

与posix兼容的表单1 /re/形成对比，该表单创建了一个范围，从第一行匹配到后续行中与re匹配的行;换句话说:这将不会检测第一次出现的re匹配，如果它恰好出现在第一行，并且还防止使用简写//来重用最近使用的正则表达式(参见下一点).1

如果将0，/re/地址与s/…/…/(替换)调用使用相同的正则表达式，您的命令将有效地只对匹配re的第一行执行替换。 Sed为重用最近应用的正则表达式提供了一种方便的快捷方式:空分隔符对//。

$ sed '0,/foo/ s//bar/' <<<$'1st foo\nUnrelated\n2nd foo\n3rd foo' 
1st bar         # only 1st match of 'foo' replaced
Unrelated
2nd foo
3rd foo

---

只支持posix特性的sed，例如BSD (macOS) sed(也适用于GNU sed):

由于0，/re/不能使用，并且形式1，/re/将不会检测到re，如果它恰好出现在第一行(见上文)，因此需要对第一行进行特殊处理。

MikhailVS的回答提到了这种技术，并举了一个具体的例子:

$ sed -e '1 s/foo/bar/; t' -e '1,// s//bar/' <<<$'1st foo\nUnrelated\n2nd foo\n3rd foo'
1st bar         # only 1st match of 'foo' replaced
Unrelated
2nd foo
3rd foo

注意:

The empty regex // shortcut is employed twice here: once for the endpoint of the range, and once in the s call; in both cases, regex foo is implicitly reused, allowing us not to have to duplicate it, which makes both for shorter and more maintainable code. POSIX sed needs actual newlines after certain functions, such as after the name of a label or even its omission, as is the case with t here; strategically splitting the script into multiple -e options is an alternative to using an actual newlines: end each -e script chunk where a newline would normally need to go.

1s /foo/bar/只在第一行替换foo，如果在第一行找到的话。 如果是，t将分支到脚本的末尾(跳过该行中剩余的命令)。(t函数只有在最近的s调用执行了实际的替换时才会分支到一个标签;在没有标签的情况下，就像这里的情况一样，脚本的结尾被分支到)。

当这种情况发生时，范围地址1，//(通常从第2行开始查找第一个出现的地址)将不匹配，并且该范围将不会被处理，因为当当前行已经是2时，该地址将被计算。

相反，如果第一行没有匹配项，则输入1，//，并找到真正的第一个匹配项。

最终效果与GNU sed的0，/re/相同:只替换第一个出现的内容，无论它出现在第一行还是其他任何一行。

---

NON-range方法

Potong的回答展示了绕过范围需求的循环技术;因为他使用GNU sed语法，这里是posix兼容的等价:

循环技术1:在第一次匹配时，执行替换，然后输入一个循环，只打印剩余的行:

$ sed -e '/foo/ {s//bar/; ' -e ':a' -e '$!{n;ba' -e '};}' <<<$'1st foo\nUnrelated\n2nd foo\n3rd foo'
1st bar
Unrelated
2nd foo
3rd foo

循环技术2，仅适用于较小的文件:将整个输入读入内存，然后对其执行一次替换。

$ sed -e ':a' -e '$!{N;ba' -e '}; s/foo/bar/' <<<$'1st foo\nUnrelated\n2nd foo\n3rd foo'
1st bar
Unrelated
2nd foo
3rd foo

---

1 1.61803提供了1，/re/，带和不带后面的s//的例子:

sed '1,/foo/ s/foo/bar/' <<<$'1foo\n2foo' yields $'1bar\n2bar'; i.e., both lines were updated, because line number 1 matches the 1st line, and regex /foo/ - the end of the range - is then only looked for starting on the next line. Therefore, both lines are selected in this case, and the s/foo/bar/ substitution is performed on both of them. sed '1,/foo/ s//bar/' <<<$'1foo\n2foo\n3foo' fails: with sed: first RE may not be empty (BSD/macOS) and sed: -e expression #1, char 0: no previous regular expression (GNU), because, at the time the 1st line is being processed (due to line number 1 starting the range), no regex has been applied yet, so // doesn't refer to anything. With the exception of GNU sed's special 0,/re/ syntax, any range that starts with a line number effectively precludes use of //.

使用FreeBSD ed，避免ed在文件中没有include语句时出现“no match”错误:

teststr='
#include <stdio.h>
#include <stdlib.h>
#include <inttypes.h>
'

# using FreeBSD ed
# to avoid ed's "no match" error, see
# *emphasized text*http://codesnippets.joyent.com/posts/show/11917 
cat <<-'EOF' | sed -e 's/^ *//' -e 's/ *$//' | ed -s <(echo "$teststr")
   H
   ,g/# *include/u\
   u\
   i\
   #include "newfile.h"\
   .
   ,p
   q
EOF

这可能为你工作(GNU sed):

sed -si '/#include/{s//& "newfile.h\n&/;:a;$!{n;ba}}' file1 file2 file....

或者如果内存不是问题:

sed -si ':a;$!{N;ba};s/#include/& "newfile.h\n&/' file1 file2 file...

我需要一个在GNU和BSD上都可以工作的解决方案，而且我也知道第一行永远不会是我需要更新的一行:

sed -e "1,/pattern/s/pattern/replacement/"

尝试//特性不重复模式对我不起作用，因此需要重复它。

一个可能的解决方案:

    /#include/!{p;d;}
    i\
    #include "newfile.h"
    :a
    n
    ba

解释:

读取行，直到找到#include，打印这些行，然后开始新的循环 插入新的包含行 输入一个只读取行(默认情况下sed也会打印这些行)的循环，我们不会从这里回到脚本的第一部分