sed コマンドの使い方 - 置換とアドレス指定の基本、-i の GNU 版と macOS 版の違い

sed コマンドの使い方 - 置換とアドレス指定の基本、-i の GNU 版と macOS 版の違い

作成日:
読了:約50分
更新日:

当サイトは Amazon.co.jp を宣伝しリンクすることで紹介料を得る手段を提供する、Amazonアソシエイト・プログラムの参加者です。価格・在庫はリンク先の最新情報をご確認ください。

「設定ファイルのポート番号をスクリプトで書き換えたい」「ログからコメント行と空行を取り除きたい」「プロジェクト内の古いドメイン名をまとめて置き換えたい」。こうした作業で長く使われているのがsedです。

sedはs/old/new/の置換だけなら簡単ですが、少し踏み込むと「-nを付けたら何も出なくなった」「+が効かない」「Linuxで動いたsed -iがmacOSでエラーになる」「\nで改行を置き換えられない」といった壁に当たります。多くは、sedが1行ずつ処理する仕組みと、GNU版とmacOS(BSD)版の違いを知っていれば避けられます。

この記事では、sedの処理モデルから始めて、sコマンドのフラグ、オプション、アドレス指定、よく使うコマンド、-iによるファイルの直接編集、実務のレシピ、つまずきやすいところまでを、実際の実行結果を見ながら順に説明します。

先に結論: よく使う書き方の早見表

やりたいこと書き方
各行で最初の1つを置換するsed 's/old/new/' file
各行の一致をすべて置換するsed 's/old/new/g' file
2つ目の一致だけを置換するsed 's/old/new/2' file
大文字小文字を区別せずに置換するsed 's/old/new/I' file
置換した行だけを表示するsed -n 's/old/new/p' file
拡張正規表現(ERE)を使うsed -E 's/[0-9]+/N/' file
3行目だけを表示するsed -n '3p' file
2行目から4行目を表示するsed -n '2,4p' file
パターンに一致する行を表示するsed -n '/ERROR/p' file
パターンに一致する行を削除するsed '/DEBUG/d' file
コメント行と空行を削除するsed -e '/^#/d' -e '/^$/d' file
最初の10行で止めるsed 10q file
行数を数えるsed -n '$=' file
ファイルを直接書き換える(GNU sed)sed -i 's/old/new/' file
ファイルを直接書き換える(macOS)sed -i '' 's/old/new/' file
バックアップを残して書き換える(両方で動く)sed -i.bak 's/old/new/' file

パスのようにスラッシュを含む文字列を置換するときは、区切り文字を変えると読みやすくなります。

sed 's|/usr/local|/opt|' file
sed 's#/usr/local#/opt#' file

覚えておきたい習慣は次の4つです。

  • sedのスクリプトは'...'のようにシングルクォートで囲む。シェル変数を埋め込むときだけダブルクォートにする
  • +、?、|、(...)を正規表現として使うなら-Eを付ける。付けないと普通の文字として扱われる(GNU sedの\+などはmacOSでは使えない)
  • -iはGNU sedとmacOSで書き方が違う。両方で動かすなら-i.bakのようにバックアップの拡張子をくっつけて書く
  • -nと-iを一緒に使うときは、pで出力しないとファイルが空になる

実行結果を採取した環境

NOTE

2026年11月19日に、GNU sed 4.10のソースに同梱のマニュアル(doc/sed.texi)とNEWS(変更履歴)、macOSのsedのmanページ、POSIX.1-2024(The Open Group Base Specifications Issue 8)のsedの仕様で内容を確認しました。GNU sedの最新版は、GNUのFTPサーバーの表示とNEWSの記載で4.10(2026年4月21日公開)です。手元のHomebrewで入っていたGNU sedは4.9で、実行結果は4.9のものです。実行結果は、macOS 27.2、zsh 5.9で採取しています。

使ったコマンドのバージョンは次のとおりです。

$ what /usr/bin/sed
/usr/bin/sed:
	PROGRAM:sed  PROJECT:text_cmds-201
	PROGRAM:sed  PROJECT:text_cmds-201
	PROGRAM:sed  PROJECT:text_cmds-201
 
$ gsed --version | head -1
gsed (GNU sed) 4.9

macOS標準の/usr/bin/sedはFreeBSD由来の実装で、--versionオプションはありません。Linuxの多くのディストリビューションで使われているGNU sedは、Homebrewのgnu-sedパッケージで試しました。Homebrewではgsedという名前で入ります。

以下、$ sedで始まる実行結果はmacOSのsed、$ gsedで始まるものはGNU sedです。Linuxではgsedをsedに読み替えてください。

試したファイルは次のようなものです。

$ cat fruits.txt
apple 100
banana 200
cherry 300
apple pie 400
grape 500
 
$ cat app.conf
# サンプル設定ファイル
port=8080
 
host=localhost
# debug=false
debug=true
 
log_dir=/var/log/sample-app
 
$ cat multi.ini
[server]
port=80
[database]
port=5432
user=sample
[cache]
port=6379

sed とは: 1行ずつ処理するストリームエディタ

sedは「stream editor」の略で、入力を先頭から1行ずつ読み、決められた編集をして出力するコマンドです。エディタでファイルを開いて手で直す代わりに、編集の手順をスクリプトとして渡します。

sed [オプション] スクリプト [ファイル...]

ファイルを省略すると標準入力を読みます。パイプで受け取ったコマンドの出力を書き換える使い方もよくあります。パイプの仕組みはパイプとリダイレクトの仕組みで説明しています。

$ echo 'hello world' | sed 's/world/sed/'
hello sed

パターンスペースとホールドスペース

sedの動きを理解するうえで大事なのが、パターンスペースという作業用の領域です。sedは次の手順を1行ごとに繰り返します。この1回分をサイクルと呼びます。

  1. 入力から1行を読み、行末の改行を取り除いてパターンスペースに入れる
  2. スクリプトのコマンドを上から順に、パターンスペースに対して実行する
  3. スクリプトの最後まで来たら、パターンスペースの内容に改行を付けて出力する(-nを付けると出力しない)
  4. パターンスペースを空にして、次の行へ進む

ポイントは2つあります。1つは、何も指定しなければ各行が自動で出力されることです。-nはこの自動出力を止めるオプションで、pコマンドと組み合わせて「指定した行だけを出す」ために使います。もう1つは、行末の改行がパターンスペースに入らないことです。そのためs/\n/,/と書いても、普通は何も置換されません(後述)。

もう1つの領域がホールドスペースです。サイクルをまたいで内容を保存しておける置き場所で、h(パターンスペースをホールドスペースへコピー)、H(追記)、g(ホールドスペースをパターンスペースへコピー)、G(追記)、x(入れ替え)のコマンドで使います。日常の置換ではほとんど使いませんが、たとえば行の順番を逆にする処理は次のように書けます。

$ cat three.txt
first
second
third
 
$ sed -n '1!G;h;$p' three.txt
third
second
first

1行目以外ではGでホールドスペースの内容(それまでの行)を後ろに付け、hでその結果をホールドスペースに保存し、最終行($)でだけpで出力しています。実務ではtail -r(macOS)やtac(Linux)を使う方が簡単ですが、パターンスペースとホールドスペースの関係をつかむ例として覚えておくとよいでしょう。

s コマンドの基本

sedで一番使うのが置換のsコマンドです。

s/正規表現/置換後の文字列/フラグ

フラグを付けないと、各行で最初に一致した1か所だけを置換します。

$ sed 's/apple/APPLE/' fruits.txt
APPLE 100
banana 200
cherry 300
APPLE pie 400
grape 500

sedは結果を標準出力に出すだけで、元のファイルは変わりません。ファイルを書き換える方法は「-i によるファイルの直接編集」で説明します。

フラグ: g・数字・I・p・w

フラグで置換の範囲や動きを変えられます。

$ echo 'aaa bbb aaa ccc aaa' | sed 's/aaa/X/'
X bbb aaa ccc aaa
 
$ echo 'aaa bbb aaa ccc aaa' | sed 's/aaa/X/g'
X bbb X ccc X
 
$ echo 'aaa bbb aaa ccc aaa' | sed 's/aaa/X/2'
aaa bbb X ccc aaa
 
$ echo 'aaa bbb aaa ccc aaa' | gsed 's/aaa/X/2g'
aaa bbb X ccc X
 
$ echo 'aaa bbb aaa ccc aaa' | sed 's/aaa/X/2g'
sed: 1: "s/aaa/X/2g
": more than one number or 'g' in substitute flags
  • g: 行の中の一致をすべて置換する
  • 数字N: N番目の一致だけを置換する
  • 数字とgの組み合わせ(2gなど): N番目以降をすべて置換する。GNU sedでは使えますが、macOSのsedではエラーになりました

大文字小文字を区別しないときはI(またはi)を付けます。手元ではどちらもmacOSとGNU sedの両方で動きました。POSIXの仕様でも、Issue 8(POSIX.1-2024)でsコマンドのiフラグが追加されています。

$ echo 'Apple APPLE apple' | sed 's/apple/x/gI'
x x x

pは、置換が起きた行を出力します。-nと組み合わせると「置換した行だけを確認する」使い方ができます。-nを付けないと、自動出力とpの両方で同じ行が2回出ます。

$ sed -n 's/apple/APPLE/p' fruits.txt
APPLE 100
APPLE pie 400
 
$ sed 's/apple/APPLE/p' fruits.txt
APPLE 100
APPLE 100
banana 200
cherry 300
APPLE pie 400
APPLE pie 400
grape 500

w ファイル名は、置換が起きた行をそのファイルへ書き出します。

$ sed -n 's/apple/APPLE/w changed.txt' fruits.txt; cat changed.txt
APPLE 100
APPLE pie 400

wの後ろはファイル名として行末まで読まれるので、wは必ずフラグの最後に書きます。

区切り文字を変える

sの区切りは/でなくてもかまいません。sの直後に書いた1文字が区切りになります。パスのように/を含む文字列を置換するとき、/のままだと\/とエスケープを重ねることになり、読みにくくなります。

$ echo '/usr/local/bin' | sed 's/\/usr\/local/\/opt/'
/opt/bin
 
$ echo '/usr/local/bin' | sed 's|/usr/local|/opt|'
/opt/bin
 
$ echo '/usr/local/bin' | sed 's#/usr/local#/opt#'
/opt/bin

バックスラッシュと改行以外なら区切りに使えます。よく使われるのは|、#、,、:あたりです。置換する文字列に含まれない文字を選んでください。

アドレス(後述)の正規表現で区切りを変えるときは、先頭にバックスラッシュを付けて\|正規表現|のように書きます。sとは書き方が違うので注意してください。

$ cat paths.txt
/var/log/app.log
/etc/hosts
/var/log/nginx/access.log
 
$ sed -n '\|^/var/log/|p' paths.txt
/var/log/app.log
/var/log/nginx/access.log

& と \1 で一致した部分を使う

置換後の文字列の中の&は、正規表現に一致した部分全体に置き換わります。

$ sed 's/[0-9][0-9]*/[&]/' fruits.txt
apple [100]
banana [200]
cherry [300]
apple pie [400]
grape [500]
 
$ echo 'cat' | sed 's/cat/& and dog/'
cat and dog

文字としての&を入れたいときは\&とエスケープします。置換後の文字列に&が入っていて結果がおかしくなる、というのはよくある失敗です。

$ echo 'cat' | sed 's/cat/R\&D/'
R&D

正規表現の一部をグループにしておくと、置換後の文字列で\1、\2のように番号で参照できます(後方参照)。BREでは\(...\)、-Eを付けたEREでは(...)でグループを作ります。

$ echo '2026-11-19' | sed 's/\([0-9]*\)-\([0-9]*\)-\([0-9]*\)/\3\/\2\/\1/'
19/11/2026
 
$ echo '2026-11-19' | sed -E 's/([0-9]+)-([0-9]+)-([0-9]+)/\3\/\2\/\1/'
19/11/2026

GNU sedには、置換後の文字列で\U(以降を大文字に)、\L(以降を小文字に)、\u、\l(次の1文字だけ)を使う拡張があります。macOSのsedでは使えず、Uがそのまま文字として出ました。

$ echo 'user: sample' | gsed 's/user: \(.*\)/name=\U\1/'
name=SAMPLE
 
$ echo 'user: sample' | sed 's/user: \(.*\)/name=\U\1/'
name=Usample

オプション: -n・-e・-f・-E

-n と p: 指定した行だけを出す

前述のとおり、-nは自動出力を止めます。pコマンドやsのpフラグと組み合わせて、grepのように行を絞り込むときに使います。

$ sed -n '/apple/p' fruits.txt
apple 100
apple pie 400

-nを付けてpを書き忘れると、何も出力されません。「sedを実行したのに何も出ない」ときは、まず-nを疑ってください。

-e と -f: コマンドを複数渡す

複数のコマンドは-eを重ねるか、;で区切って書きます。

$ sed -n -e '/banana/p' -e '/grape/p' fruits.txt
banana 200
grape 500

長いスクリプトはファイルに書いておき、-fで読み込めます。1行に1コマンドを書き、#から行末まではコメントになります。

$ cat edit.sed
s/apple/APPLE/
/^$/d
# comment
/banana/a\
after banana
 
$ cat dup.txt
apple
banana
apple
 
$ sed -f edit.sed dup.txt
APPLE
banana
after banana
APPLE

-E: BRE と ERE の違い

sedの正規表現は、何も付けないとBRE(基本正規表現)、-Eを付けるとERE(拡張正規表現)になります。-EはmacOSのsedとGNU sedの両方で使え、POSIXでもIssue 8(POSIX.1-2024)で標準になりました。GNU sedでは古くからの-rも同じ意味で、macOSのsedにもGNU sedとの互換のための-rがあります。

BREでは+、?、|、(、)、{、}が普通の文字です。そのため、EREのつもりで+を書くと、何も一致せずに素通りします。

$ echo 'price: 100 yen' | sed 's/[0-9]+/N/'
price: 100 yen
 
$ echo 'price: 100 yen' | sed -E 's/[0-9]+/N/'
price: N yen

GNU sedでは、BREでも\+、\?、\|と書くとEREの+、?、|と同じ意味になります。ただしこれはGNUの拡張で、macOSのsedでは一致しませんでした。

$ echo 'price: 100 yen' | gsed 's/[0-9]\+/N/'
price: N yen
 
$ echo 'price: 100 yen' | sed 's/[0-9]\+/N/'
price: 100 yen
 
$ gsed 's/\(apple\|banana\)/[\1]/' dup.txt
[apple]
[banana]
[apple]
 
$ sed 's/\(apple\|banana\)/[\1]/' dup.txt
apple
banana
apple
 
$ sed -E 's/(apple|banana)/[\1]/' dup.txt
[apple]
[banana]
[apple]

回数指定の\{n\}はBREの標準なので、どちらでも使えます。

$ echo 'price: 100 yen' | sed 's/[0-9]\{2\}/N/'
price: N0 yen

macOSとLinuxの両方で動かすスクリプトでは、\+や\|を避けて-Eを付けて書くのが無難です。BRE・ERE・PCREの違いはgrep と ripgrep の使い方でも説明しています。

アドレス指定で対象の行を絞る

コマンドの前にアドレスを書くと、そのコマンドを実行する行を絞り込めます。アドレスを書かなければ全行が対象です。

行番号・$・正規表現

$ sed -n '2p' fruits.txt
banana 200
 
$ sed -n '$p' fruits.txt
grape 500
 
$ sed -n '/apple/p' fruits.txt
apple 100
apple pie 400
  • 数字: その行番号の行
  • $: 最終行
  • /正規表現/: 正規表現に一致する行

$はシェルの変数展開にも使われる文字なので、シングルクォートの中に書きます。

範囲: 1,5 と /start/,/end/

カンマで2つのアドレスをつなぐと範囲になります。範囲は両端を含みます。

$ sed -n '2,4p' fruits.txt
banana 200
cherry 300
apple pie 400
 
$ sed -n '3,$p' fruits.txt
cherry 300
apple pie 400
grape 500
 
$ sed -n '/banana/,/apple/p' fruits.txt
banana 200
cherry 300
apple pie 400

正規表現の範囲は、1つ目に一致した行から始まり、2つ目に一致した行で終わります。終わりの行が見つからなければ、最後の行まで続きます。範囲が終わったあとに再び1つ目に一致する行があれば、そこから次の範囲が始まります。

INIファイルの特定のセクションを取り出すときに便利です。

$ sed -n '/^\[database\]/,/^\[/p' multi.ini
[database]
port=5432
user=sample
[cache]

次のセクションの見出し[cache]まで含まれている点に注意してください。範囲の中でさらに条件を絞るときは、波かっこでコマンドをまとめます。

$ sed -n '/^\[database\]/,/^\[/{/^port=/p;}' multi.ini
port=5432

波かっこの中の最後のコマンドの後ろに;を付けているのは、macOSのsedのためです。{/^port=/p}と書くと、GNU sedでは動きますが、macOSのsedではextra characters at the end of p commandというエラーになりました。

! で否定する

アドレスの後ろに!を付けると、一致しない行が対象になります。

$ sed -n '/apple/!p' fruits.txt
banana 200
cherry 300
grape 500
 
$ sed '2!d' fruits.txt
banana 200

sed '2!d'は「2行目以外を削除する」なので、結果として2行目だけが残ります。

範囲の終わりの正規表現は次の行から探す

範囲の2つ目が正規表現のとき、その正規表現は範囲が始まった行の次の行から探されます。そのため、1,/apple/と書くと、1行目がappleでもそこでは範囲が終わりません。

$ cat dup.txt
apple
banana
apple
 
$ sed '1,/apple/s/apple/FIRST/' dup.txt
FIRST
banana
FIRST

「最初に出てくるappleだけを置換したい」なら、GNU sedでは0,/apple/と書きます。アドレス0はGNUの拡張で、1行目から終わりの正規表現を探すという意味になります。

$ gsed '0,/apple/s/apple/FIRST/' dup.txt
FIRST
banana
apple
 
$ sed '0,/apple/s/apple/FIRST/' dup.txt; echo "status=$?"
apple
banana
apple
status=0

macOSのsedでは、0,/apple/はエラーにならず、何も置換されませんでした。気づきにくいので注意してください。

GNU 拡張: first~step、addr,+N、addr,~N

GNU sedには、ほかにも便利なアドレスがあります。

$ seq 1 10 > num.txt
 
$ gsed -n '1~3p' num.txt
1
4
7
10
 
$ gsed -n '0~4p' num.txt
4
8
 
$ gsed -n '/banana/,+1p' fruits.txt
banana 200
cherry 300
 
$ gsed -n '/banana/,~4p' fruits.txt
banana 200
cherry 300
apple pie 400
  • first~step: first行目からstep行おき。0~4は4の倍数の行
  • addr,+N: addrに一致した行と、その後のN行
  • addr,~N: addrに一致した行から、行番号がNの倍数になる行まで

macOSのsedでは、1~3pはinvalid command code ~というエラーになりました。一方、addr,+NはmacOSのmanページにも記載があり、手元でも同じ結果になりました。+Nの形はPOSIXの仕様にはないので、ほかの環境でも動くとは限りません。

$ sed -n '/banana/,+1p' fruits.txt
banana 200
cherry 300
 
$ sed -n '1~3p' num.txt
sed: 1: "1~3p
": invalid command code ~

よく使うコマンド: d・p・a・i・c・y・q・=・r

d: 行を削除する

dはパターンスペースを捨てて、次のサイクルへ進みます。その行は出力されません。

$ sed '2,4d' fruits.txt
apple 100
grape 500
 
$ sed '/apple/d' fruits.txt
banana 200
cherry 300
grape 500

a・i・c: 行を追加する、置き換える

aは行の後ろに、iは行の前に文字列を追加します。cは行をまるごと置き換えます。

GNU sedでは、コマンドの後ろに続けて文字列を書けます。

$ gsed '2a inserted after line 2' fruits.txt
apple 100
banana 200
inserted after line 2
cherry 300
apple pie 400
grape 500
 
$ gsed '1i # header' fruits.txt | head -3
# header
apple 100
banana 200
 
$ gsed '/cherry/c cherry 999' fruits.txt
apple 100
banana 200
cherry 999
apple pie 400
grape 500
 
$ gsed '$a last line' fruits.txt | tail -2
grape 500
last line

この1行で書く形はGNUの拡張です。macOSのsedではcommand a expects \ followed by textというエラーになります。macOSでも動かすには、a\の直後で改行し、次の行に追加する文字列を書きます。この書き方はGNU sedでも動きます。

$ sed '2a inserted after line 2' fruits.txt
sed: 1: "2a inserted after line 2
": command a expects \ followed by text
 
$ sed '2a\
inserted after line 2
' fruits.txt
apple 100
banana 200
inserted after line 2
cherry 300
apple pie 400
grape 500

y: 文字を1対1で置き換える

y/abc/xyz/は、aをxに、bをyに、cをzに、というように文字単位で置き換えます。正規表現は使えず、2つの文字列は同じ長さにします。

$ echo 'hello world' | sed 'y/abcdefghijklmnopqrstuvwxyz/ABCDEFGHIJKLMNOPQRSTUVWXYZ/'
HELLO WORLD

大文字小文字の変換だけならtrを使う方が簡単です。

q: 途中で終了する

qはその行を出力してから終了します。sed 10qはhead -10と同じ結果になります。大きなファイルでも、必要な行まで読んだら止まるので無駄がありません。

$ sed 3q fruits.txt
apple 100
banana 200
cherry 300

GNU sedでは、qに終了ステータスを付けられます。また、出力せずに終了するQもあります。

$ gsed '/cherry/q5' fruits.txt; echo "status=$?"
apple 100
banana 200
cherry 300
status=5
 
$ gsed '/cherry/Q' fruits.txt
apple 100
banana 200

=: 行番号を出す

=は行番号を出力します。$=で最終行の番号、つまり行数がわかります。

$ sed -n '$=' fruits.txt
5
 
$ sed -n '/apple/=' fruits.txt
1
4

r: ファイルの内容を差し込む

r ファイル名は、その行の後ろにファイルの内容を差し込みます。ファイルが読めなくてもエラーにはなりません。

$ cat extra.conf
Include extra.conf
 
$ sed '/cherry/r extra.conf' fruits.txt
apple 100
banana 200
cherry 300
Include extra.conf
apple pie 400
grape 500

l: 見えない文字を確かめる

lは、タブや改行コードなどの見えない文字をエスケープして表示します。行末には$が付きます。CRLFのファイルかどうかを確かめるときに便利です。

$ sed -n l crlf.txt
line1\r$
line2\r$

-i によるファイルの直接編集

-iを付けると、結果を標準出力に出す代わりに、元のファイルを書き換えます。便利な反面、GNU sedとmacOSのsedで書き方が違い、事故も起きやすいオプションです。

なお、-iはPOSIXの仕様にはありません。GNU sedとBSD系のsedがそれぞれ独自に実装した機能です。

GNU sed と macOS sed で書き方が違う

違いは、バックアップ用の拡張子を「必ず受け取るか」です。

  • GNU sed: -iの拡張子は省略できる。付けるなら-i.bakのように空白を空けずに書く
  • macOSのsed: -iの次の引数を必ず拡張子として受け取る。バックアップが不要なら空文字列''を渡す

GNU sedでは、-iだけでバックアップなしに書き換わります。

$ gsed -i 's/8080/9090/' app.conf; cat app.conf
port=9090
host=localhost

同じコマンドをmacOSで実行すると、スクリプトの's/8080/9090/'が拡張子として扱われ、ファイル名のapp.confがスクリプトとして解釈されます。app.confの先頭のaが「aコマンド」と読まれるため、次のような分かりにくいエラーになります。

$ sed -i 's/8080/9090/' app.conf
sed: 1: "app.conf
": command a expects \ followed by text

macOSでバックアップを作らないなら、''を渡します。

$ sed -i '' 's/8080/9090/' app.conf; cat app.conf
port=9090
host=localhost

逆に、GNU sedに-i ''を渡すと、''がスクリプト、's/8080/9090/'がファイル名と解釈されてエラーになります。

$ gsed -i '' 's/8080/9090/' app.conf
gsed: can't read s/8080/9090/: No such file or directory

もう1つ、macOSでよく起きるのが-i -eの組み合わせです。-eが拡張子として受け取られ、app.conf-eというバックアップができてしまいます。

$ sed -i -e 's/8080/9090/' app.conf; ls
app.conf
app.conf-e

両方で動く書き方: -i.bak

-i.bakのように拡張子を-iにくっつけて書くと、GNU sedとmacOSのsedのどちらでも同じ意味になります。

$ sed -i.bak 's/8080/9090/' app.conf; ls; cat app.conf.bak
app.conf
app.conf.bak
port=8080
host=localhost
 
$ gsed -i.bak 's/8080/9090/' app.conf; ls
app.conf
app.conf.bak

バックアップが不要なら、書き換えが終わってからrm app.conf.bakで消します。スクリプトをLinuxとmacOSの両方で使うなら、この書き方にしておくのが確実です。

GNU sedでは-iの後ろに続けて書いた文字が拡張子になるので、-iEのようにほかのオプションを続けて書くと、Eが拡張子になります。-Eiの順なら、-E -iと同じ意味です。

$ gsed -iE 's/8080/9090/' app.conf; ls
app.conf
app.confE

-n と -i を組み合わせるとファイルが空になる

-iは、sedが出力した内容でファイルを置き換えます。-nで自動出力を止めてpを書かないと、出力が空になり、ファイルも空になります。GNU sedのマニュアルにも、誤った使い方の例として載っています。

$ gsed -ni 's/8080/9090/' app.conf; wc -c app.conf
       0 app.conf

pを付けると、置換した行だけがファイルに残ります。ほかの行は消えるので、これも意図した結果ではないことが多いはずです。

$ gsed -n -i 's/8080/9090/p' app.conf; cat app.conf
port=9090

-iを使うときは、まず-iなしで実行して出力を確認し、問題がなければ-iを付ける、という順番にすると安全です。Gitで管理しているファイルなら、書き換えたあとにgit diffで差分を確認できます。

-iを付けたまま、置換した行を画面にも出したいときは、GNU sedではw /dev/stdoutを使います。

$ gsed -i 's/8080/9090/w /dev/stdout' app.conf
port=9090

-i は複数のファイルを別々に扱う(-s)

sedは通常、複数のファイルを渡されると、それらをつなげた1本の入力として扱います。行番号は通算になり、$は最後のファイルの最終行だけを指します。

$ sed -n '$=' a.txt b.txt
4
 
$ gsed -s -n '$=' a.txt b.txt
2
2

GNU sedの-s(--separate)を付けると、ファイルごとに行番号が1から数え直され、$は各ファイルの最終行を指すようになります。マニュアルによると、-iは-sを含んでいます。macOSのsedの-iも、manページの説明では各ファイルを別々に扱います(macOSには、ファイルをつなげたまま書き換える-Iもあります)。

シンボリックリンクとハードリンク

GNU sedの-iは、一時ファイルに結果を書き、最後に元のファイル名へリネームします。そのため、リンクの扱いに注意が必要です。

シンボリックリンクを渡すと、GNU sedは既定ではリンクを普通のファイルで置き換え、リンク先は変更しません。リンク先を書き換えたいときは--follow-symlinksを付けます。

$ ls -l link.conf | cut -c1-10
lrwxr-xr-x
 
$ gsed -i 's/8080/9090/' link.conf; ls -l link.conf | cut -c1-10; cat real/app.conf
-rw-r--r--
port=8080
$ gsed -i --follow-symlinks 's/8080/9090/' link.conf; ls -l link.conf | cut -c1-10; cat real/app.conf
lrwxr-xr-x
port=9090

1つ目では、link.confがシンボリックリンクから普通のファイル(-rw-r--r--)に変わり、リンク先のreal/app.confは8080のままです。macOSのsedは、シンボリックリンクに-iを使うとエラーになりました。

$ sed -i '' 's/8080/9090/' link.conf
sed: link.conf: in-place editing only works for regular files

なお、GNU sed 4.10のNEWSには、--follow-symlinks -iでリンクの解決とファイルを開く間にリンクを差し替えられる競合状態(TOCTOU)を修正した、という記載があります。共有ディレクトリなど、ほかのユーザーが書き込める場所で--follow-symlinksを使う場合は、4.10以降を使うのが安心です。

ハードリンクも、リネームによって別のファイルになります。次の例では、-iのあとでa.confのiノード番号が変わり、ハードリンクのhard.confは古い内容のまま残りました。

$ ls -i a.conf hard.conf
399814814 a.conf
399814814 hard.conf
 
$ gsed -i 's/8080/9090/' a.conf
 
$ ls -i a.conf hard.conf
399814817 a.conf
399814814 hard.conf
 
$ cat hard.conf
port=8080

macOS で GNU sed を使う

macOSでもGNU sedと同じ書き方をしたいなら、Homebrewのgnu-sedを入れる方法があります。

brew install gnu-sed

gsedという名前で使えるようになります。sedの名前でGNU sedを使いたい場合は、/opt/homebrew/opt/gnu-sed/libexec/gnubinをPATHの先頭に追加します(Apple Silicon Macの場合のパスです)。ただし、PATHを変えると、macOSのsedを前提にしたほかのツールやスクリプトにも影響します。スクリプトの中ではgsedと明示する方が、どちらのsedを使っているかが分かりやすくなります。

実務レシピ

設定ファイルの値を書き換える

キー=値の形の設定は、行頭からキーを指定して行全体を置き換えると確実です。

$ sed 's/^port=.*/port=9090/' app.conf | head -3
# サンプル設定ファイル
port=9090
 

=の前後に空白が入る形式なら、キーと=の部分をグループにして残します。

$ printf 'host = localhost\n' | sed -E 's/^(host[[:space:]]*=[[:space:]]*).*/\1db.example.com/'
host = db.example.com

キーに^を付けておくと、# port=8080のようにコメントアウトされた行は対象になりません。

INI のセクション内だけ書き換える

範囲のアドレスと組み合わせると、特定のセクションの中だけを書き換えられます。

$ sed '/^\[database\]/,/^\[/s/^port=.*/port=15432/' multi.ini
[server]
port=80
[database]
port=15432
user=sample
[cache]
port=6379

[server]と[cache]のportはそのままです。

コメント行と空行を削除する

設定ファイルの有効な行だけを見たいときによく使います。

$ sed -e '/^#/d' -e '/^$/d' app.conf
port=8080
host=localhost
debug=true
log_dir=/var/log/sample-app

インデントされたコメントや、空白だけの行も消すなら、[[:space:]]*を入れます。

$ sed '/^[[:space:]]*#/d; /^[[:space:]]*$/d' app.conf
port=8080
host=localhost
debug=true
log_dir=/var/log/sample-app

行末のコメントを消すなら、sで#から後ろを削ります。ただし、値の中に#を含む形式では値まで削れてしまうので、対象のファイルに合わせて確認してください。

$ echo 'key = value  # comment' | sed -E 's/[[:space:]]*#.*$//'
key = value

特定の行を抜き出す

行番号や範囲で抜き出すなら-nとp、途中で止めてよいならqを使います。大きなログの一部だけを見るときに便利です。

sed -n '100,120p' app.log    # 100行目から120行目
sed -n '/09:00/,/09:05/p' app.log    # 09:00を含む行から09:05を含む行まで
sed '120q' app.log | tail -21    # 120行目まで読んだら止める

行末の CRLF を LF にする

Windowsで作られたファイルは、行末が\r\n(CRLF)になっていることがあります。シェルスクリプトがCRLFのままだと、行末の\rがコマンドの一部と解釈されて動きません。行末の\rを消します。

$ file -b crlf.txt
ASCII text, with CRLF line terminators
 
$ sed 's/\r$//' crlf.txt | od -c | head -2
0000000    l   i   n   e   1  \n   l   i   n   e   2  \n
0000014

手元のmacOS 27.2のsedでも\rが使えましたが、古いバージョンのmacOSでの挙動は確認していません。\rが効かない環境では、bashやzshの$'...'で本物のCR文字をスクリプトに埋め込む方法があります。

$ sed $'s/\r$//' crlf.txt | od -c | head -2
0000000    l   i   n   e   1  \n   l   i   n   e   2  \n
0000014

複数のファイルをまとめて置換する

置換の対象になるファイルをgrep -rlやrg -lで探し、xargsでsed -iに渡します。

$ rg -n 'example\.com' .
./src/app.js:1:const API = 'http://old.example.com/api'
./src/lib/util.js:1:fetch('http://old.example.com/v2')
./README.md:1:old.example.com
 
$ rg -l 'old\.example\.com' . | xargs sed -i '' 's/old\.example\.com/new.example.com/g'
 
$ rg -n 'example\.com' .
./src/app.js:1:const API = 'http://new.example.com/api'
./src/lib/util.js:1:fetch('http://new.example.com/v2')
./README.md:1:new.example.com

rg -lの後ろに検索するディレクトリ(.)を書いているのは、スクリプトの中でも確実に動かすためです。手元では、標準入力が端末につながっていない状態でパスを省略してrg -l パターンを実行すると、rgが標準入力を読みに行き、止まったままになりました。

拡張子で対象を絞るならfindを使います。ファイル名に空白が入っていても壊れないよう、-print0とxargs -0を組み合わせます。

$ find . -name '*.js' -print0 | xargs -0 sed -i '' 's/new\.example\.com/api.example.com/g'
 
$ rg -n 'example\.com' .
./src/app.js:1:const API = 'http://api.example.com/api'
./src/lib/util.js:1:fetch('http://api.example.com/v2')
./README.md:1:new.example.com

ここではmacOSのsed -i ''を使っています。Linuxではsed -i、両方で動かすならsed -i.bakにしてください。findとxargsの組み合わせはfind と xargs の使い方で詳しく説明しています。

一括置換は影響範囲が広いので、先にrg -nやgrep -rnで対象の行を確認し、Gitで管理しているディレクトリなら置換後にgit diffで差分を見てからコミットするのがおすすめです。

つまずきやすいところ

正規表現は貪欲にマッチする

.*は、一致する範囲のうちできるだけ長い部分に一致します(貪欲マッチ)。HTMLのタグを消すつもりで<.*>と書くと、最初の<から最後の>までが一度に一致します。

$ echo '<b>bold</b> and <i>italic</i>' | sed 's/<.*>/X/'
X
 
$ echo '<b>bold</b> and <i>italic</i>' | sed 's/<[^>]*>//g'
bold and italic

sedの正規表現には、PerlやPCREの.*?のような最短一致の書き方がありません。[^>]*のように「区切りの文字以外の繰り返し」で書くのが定番です。

*は0回の繰り返しにも一致する点にも注意してください。[0-9]*は行頭の空文字列に一致するので、次のように数字の前に何も無い位置で置換されます。

$ sed 's/[0-9]*/[&]/' fruits.txt | head -2
[]apple 100
[]banana 200

1文字以上の数字にしたいなら、BREでは[0-9][0-9]*、EREでは[0-9]+と書きます。

. や [ などの特殊文字はエスケープする

正規表現では.が任意の1文字に一致します。バージョン番号やIPアドレスを置換するとき、.をそのまま書くと、意図しない文字列にも一致します。

$ echo 'version=1x2y3' | sed 's/1.2.3/X/'
version=X
 
$ echo 'version=1x2y3' | sed 's/1\.2\.3/X/'
version=1x2y3

ほかにも、*、[、]、^、$、\、区切り文字に使っている文字は、文字どおりに探すならバックスラッシュでエスケープします。置換後の文字列では、&、\、区切り文字がエスケープの対象です。

シェル変数とクォート

シングルクォートの中ではシェルの変数が展開されません。変数を使いたいときはダブルクォートで囲みます。

$ new_port=9090
 
$ sed 's/8080/$new_port/' app.conf | sed -n 2p
port=$new_port
 
$ sed "s/8080/$new_port/" app.conf | sed -n 2p
port=9090

ダブルクォートの中では、$や\、バッククォートがシェルにも解釈されます。正規表現の$(行末)と変数を混ぜるときは、"s/foo\$/$new/"のように行末の$をエスケープするか、変数の部分だけをダブルクォートにして's/foo$/'"$new"'/'のようにつなげます。

変数の中身に区切り文字が含まれていると、スクリプトが壊れます。パスを変数で渡すときは、区切り文字を変えてください。

$ new_dir=/opt/sample
 
$ echo 'dir=/var/www' | sed "s/\/var\/www/$new_dir/"
sed: 1: "s/\/var\/www//opt/sample/
": bad flag in substitute command: 'o'
 
$ echo 'dir=/var/www' | sed "s|/var/www|$new_dir|"
dir=/opt/sample

変数の中身がユーザーの入力など予測できないものなら、&や\も含まれる可能性があります。その場合は、事前にエスケープするか、後述のperlやawkで文字列として扱う方が安全です。

改行はパターンスペースに入らない

sedは1行ずつ読み、行末の改行を取り除いてからパターンスペースに入れます。そのため、s/\n/,/gで改行をカンマにしようとしても、何も起きません。

$ sed 's/\n/,/g' three.txt
first
second
third

複数行をまとめて扱うには、Nコマンドで次の行をパターンスペースに追加します。Nで追加した行との間には改行が入るので、それを\nで置換できます。全行を1つのパターンスペースに集めるのが次の定番の書き方です。

$ gsed ':a;N;$!ba;s/\n/,/g' three.txt
first,second,third

:aはラベル、$!baは「最終行でなければラベルaに戻る」という意味です。macOSのsedではラベル名が;の手前で終わらず、unused labelというエラーになりました。macOSでは-eで行を分けて書きます。この書き方はGNU sedでも動きます。

$ sed ':a;N;$!ba;s/\n/,/g' three.txt
sed: 2: ":a;N;$!ba;s/\n/,/g
": unused label 'a;N;$!ba;s/\n/,/g'
first
second
third
 
$ sed -e ':a' -e 'N' -e '$!ba' -e 's/\n/,/g' three.txt
first,second,third

GNU sedには、行の区切りを改行ではなくNUL文字にする-zもあります。普通のテキストファイルなら全体が1行として読まれるので、改行を直接置換できます。ただし、最後の改行もカンマになります。

$ gsed -z 's/\n/,/g' three.txt
first,second,third,

-zは本来、find -print0のようにNUL文字で区切られたファイル名の一覧を処理するためのオプションです。

$ printf 'a\0b\0' | gsed -z 's/^/item-/' | tr '\0' '\n'
item-a
item-b

行をつなげるだけなら、sedよりpasteの方が簡単です。

$ paste -sd, three.txt
first,second,third

動きが分からないときは --debug

GNU sed 4.6以降には--debugがあり、各行でどのコマンドが実行され、パターンスペースがどう変わったかを表示します。

$ echo abc | gsed --debug 's/a/X/'
SED PROGRAM:
  s/a/X/
INPUT:   'STDIN' line 1
PATTERN: abc
COMMAND: s/a/X/
MATCHED REGEX REGISTERS
  regex[0] = 0-1 'a'
PATTERN: Xbc
END-OF-CYCLE:
Xbc

GNU sedの拡張を使っていないか確かめたいときは、--posixを付けて実行すると、拡張が無効になります。次の例では、GNU拡張の\+が使えなくなり、置換されていません。

$ echo aaa | gsed --posix 's/a\+/X/'
aaa

GNU sed と macOS(BSD)sed の違い

この記事で試した範囲の違いをまとめます。

項目GNU sedmacOSのsed
-iの拡張子省略できる(-i)必須(-i ''か-i.bak)
両方で動く-iの書き方-i.bak-i.bak
シンボリックリンクへの-iリンクを普通のファイルに置き換える(--follow-symlinksでリンク先を編集)エラーになる
-E(ERE)使える(-rも同じ)使える(-rも同じ)
BREでの\+、\?などのGNU拡張使える使えない
sのIフラグ使える使える
sの2gフラグ使えるエラー
置換後の\U、\L使える使えない
first~stepアドレス使えるエラー
0,/re/アドレス使える何も置換されない
addr,+Nアドレス使える使える
a、i、cを1行で書く使えるa\の後で改行が必要
;の後に続くラベル使える-eで分ける
波かっこの}の前の;省略できる必要
qの終了ステータス、Q使える使えない
-s、-z、--debug、--posix使える無い
--versionある無い

macOSのsedでは、/cherry/q5はextra characters at the end of q command、/cherry/Qはinvalid command code Qというエラーになりました。Linuxのサーバーで使うスクリプトをmacOSで書いてテストする、あるいはその逆をする場合は、-Eと-i.bakを使い、GNU拡張を避けて書くと、多くの違いを避けられます。

代替ツール: awk・perl・sd

sedは行単位の置換と削除が得意ですが、ほかのツールの方が書きやすい処理もあります。

  • awk: 空白やカンマで区切られた列を扱う処理。列ごとの計算や集計はsedよりawkの方がずっと簡単です
  • perl: perl -pi -eでsedのようなファイルの書き換えができます。正規表現はPerlのもので、最短一致の.*?、先読みや後読み、\dなどが使えます。macOSにもLinuxにも入っていることが多く、-iの書き方の違いを気にしなくて済みます
  • sd: Rust製の置換専用ツールです。正規表現の書き方はPCREに近く、-iのような環境ごとの違いがありません。標準では入っていないので、別途インストールが必要です
$ echo 'apple 100' | awk '{ $2 = $2 * 2; print }'
apple 200
 
$ echo 'port=8080' | perl -pe 's/(?<=port=)\d+/9090/'
port=9090

ファイルを直接書き換えるならperl -pi -e 's/old/new/g' fileのように書きます(バックアップを残すなら-pi.bak)。JSONのように構造のあるデータは、sedで書き換えると壊しやすいので、jq の使い方で紹介しているjqのような専用のツールを使ってください。

まとめ

  • sedは1行ずつパターンスペースに読み込み、スクリプトを実行して出力する。行末の改行はパターンスペースに入らない
  • -nは自動出力を止める。pと組み合わせて行を絞り込む。何も出ないときは-nを疑う
  • sのフラグはg(すべて)、数字(N番目)、I(大文字小文字を区別しない)、p(出力)、w(書き出し)
  • /を含む文字列は区切り文字を|や#に変える。&は一致した部分全体、\1はグループ
  • 既定はBRE。+、?、|、()を使うなら-E。\+や\|はGNU拡張なのでmacOSでは使えない
  • アドレスは行番号、$、/regex/、範囲、!。範囲の終わりの正規表現は次の行から探す
  • a、i、cを1行で書くのはGNU拡張。macOSでも動かすならa\の後で改行する
  • -iはGNU sedが-i、macOSが-i ''。両方で動かすなら-i.bak
  • -nと-iを一緒に使うとファイルが空になることがある。まず-iなしで確認する
  • GNU sedの-iはシンボリックリンクを普通のファイルに置き換え、ハードリンクも切る。リンク先を編集するなら--follow-symlinks
  • 改行をまたぐ処理はNかGNU sedの-z。単に行をつなげるならpaste
  • 列の処理はawk、複雑な正規表現はperl、構造のあるデータはjqなど、得意なツールに任せる

置換の対象を探すならgrep と ripgrep の使い方、見つけたファイルをまとめて処理するならfind と xargs の使い方、sedを使うシェルスクリプトを安全に書くならBash の set -euo pipefailもあわせて参考にしてください。

参考資料

tar コマンドの使い方 - tar.gz の作成・展開・一覧から除外、ssh 転送、GNU tar と macOS の bsdtar の違いまで

tar コマンドの使い方 - tar.gz の作成・展開・一覧から除外、ssh 転送、GNU tar と macOS の bsdtar の違いまで

約57分

tarコマンドの使い方を実行結果付きで説明します。tar.gzの作成(-czf)・展開(-xzf)・一覧(-tzf)と展開先の-C、特定ファイルだけの展開、tar(アーカイブ)とgzip(圧縮)の役割の違い、ハイフンなし・短い・長いオプションの書き方と-fの位置の落とし穴、-z・-j・-J・--zstdと-a(--auto-compress)、展開時の圧縮形式の自動判別、圧縮率と速度の比較、--excludeと--exclude-vcs、先頭の/が取り除かれる挙動、--strip-components、-pと--same-ownerによるパーミッションと所有者、圧縮アーカイブに-r・-uが使えない理由、--newer-mtimeと-gによる差分、tar cf - とsshのパイプ転送、GNU tarとmacOSのbsdtar(libarchive)の違い、._ファイルとCOPYFILE_DISABLE・--no-mac-metadata、zipとの違い、信用できないアーカイブの展開時の注意、よくあるエラーの意味と対処までをまとめました。

awk コマンドの使い方 - 列の抽出と集計の基本、-F・連想配列・NR==FNR と gawk・mawk・macOS 版の違い

awk コマンドの使い方 - 列の抽出と集計の基本、-F・連想配列・NR==FNR と gawk・mawk・macOS 版の違い

約62分

awkのパターンとアクションの処理モデル、$0・$1・NF・$NF・NR・FNRとレコード・フィールド、-FとFS・OFS・RS・ORS、$1=$1で行が組み直される挙動、BEGIN/END、printとprintf、比較・正規表現・範囲パターン、連想配列による集計と!seen[$0]++の重複除去、length・substr・split・sub・gsub・matchなどの組み込み関数、-vとENVIRONでのシェル変数の受け渡し、NR==FNRによる2ファイルの突き合わせ、CSVと--csv、gawk・mawk・BusyBox・macOS(BWK awk)の違い、ログ集計やdf・psの加工のレシピとつまずきやすいところを実行結果付きで説明します。

grep と ripgrep の使い方 - よく使うオプションと正規表現、使い分けの目安

grep と ripgrep の使い方 - よく使うオプションと正規表現、使い分けの目安

約55分

grepの-i・-v・-n・-r・-l・-w・-o・-A/-B/-C・-e・-F・-E・-P・-qなどよく使うオプション、BRE・ERE・PCREの違い、egrep/fgrepの非推奨、終了ステータス0/1/2とset -eの罠、GNU grepとmacOSのgrepの違い、Binary file matchesと文字コード、ripgrep(rg)の.gitignore尊重・-uuu・-t・-g・-S・-r・--jsonと、grepからrgへの読み替え表を実行結果付きで説明します。

楽天市場のおすすめPR / 楽天アフィリエイト