できない.dev

zsh「event not found」の原因と直し方

zsh: event not found は、! を含む文字列をシングルクォートで囲めば直る。
! は履歴展開の記号で、ダブルクォートの中でも展開される。
.zshrc に setopt NO_BANG_HIST と書けば機能ごと止まる。

公開: 更新:

症状できない · exit 1
echo "hello!world"
zsh: event not found: world
解決後できた · exit 0
echo "hello\!world"
hello!world

2026-11-12 に alpine:3(Zsh 5.9) で実際に打って取った出力。検証環境の詳細

要約

zsh: event not found: world は、対話シェルで打った行の ! を、zsh が履歴の参照として読んだときに出る。
! はダブルクォートの中でも展開される(新しいタブで開く)ので、シングルクォートで囲めば直る。

zsh 5.9 で打ち比べると、次のようになった。

入力結果
echo "hello!world"zsh: event not found: world
echo hello!worldzsh: event not found: world
echo 'hello!world'hello!world
echo "hello\!world"hello!world
echo "hello!"dquote> のプロンプトで止まる
echo "a! b"a! b

エラーの末尾に出る語が、! の直後の文字列である。
! のあとが空白なら展開されない。

実行例

zsh 5.9 の対話シェルに行を流し込むと、echo "hello!world" は zsh: event not found: world で終了コード 1 になる。
シングルクォートやバックスラッシュで囲むと、同じ文字列が 0 で通る。
zsh -c では履歴展開が起きず、そのまま出力される。

$ echo "hello!world"
zsh: event not found: world
$ echo $?
1
$ echo hello!world
zsh: event not found: world
$ echo $?
1
$ echo "hello!" x"
hello x
$ echo $?
0
$ echo "a! b"
a! b
$ echo $?
0
$ echo 'hello!world'
hello!world
$ echo $?
0
$ echo "hello\!world"
hello!world
$ echo $?
0
$ USER=ann; echo "$USER"'!'
ann!
$ echo $?
0
$ zsh -f -c 'echo "hello!world"'
hello!world
$ echo $?
0
$ setopt NO_BANG_HIST
$ echo "hello!world"
hello!world
$ echo "hello!"
hello!

— 2026-11-12 時点の出力

検証環境Zsh 5.9 / 2026-11-12 検証
検証日
実行環境
alpine:3 Alpine Linux v3.24
バージョン
  • Zsh 5.9

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. シングルクォートで囲む

シングルクォートの中では何も展開されない。
コミットメッセージやパスワードは、これで足りる。

git commit -m 'Fix bug!important'
export PW='abc!def'

2. バックスラッシュを置く

! の前にバックスラッシュを置く。
ダブルクォートの中でも効き、zsh ではバックスラッシュは出力に残らない。

echo "hello\!world"

bash では同じ入力が hello\!world と出力され、バックスラッシュが残る。
両方のシェルで同じ結果にしたいなら、シングルクォートを使う。

3. 変数と混ぜるなら ! だけを囲む

変数を展開したいのでシングルクォートにできないときは、! の部分だけをシングルクォートにしてつなぐ。

echo "$USER"'!'

4. 履歴展開を止める

!! や !$ を使わないなら、.zshrc で機能ごと止める。
BANG_HIST(新しいタブで開く) を外すと、! は普通の文字になる。

echo 'setopt NO_BANG_HIST' >> ~/.zshrc
source ~/.zshrc

設定したあとは、echo "hello!world" も echo "hello!" もそのまま出力され、echo !! は !! を出す。

setopt NO_BANG_HIST; echo "hello!world" のように 1 行にまとめると、同じエラーになる。
履歴展開は行を読んだ時点で行われ、setopt が動くのはそのあとだからである。

よくある原因

  1. 文字列の途中に ! がある。
    git commit -m "Fix bug!important"、export PW="abc!def"、curl "https://example.com/?q=a!b" はどれも同じエラーになる。
  2. ダブルクォートの中の文字列が ! で終わっている。
    zsh は !" という並びを、その行の履歴展開を止める指定として読み、!" を取り除く。
    閉じる " まで消えるので、dquote> で続きを待つ。
    echo "hello!" x" を打つと hello x と出るので、取り除かれたことが分かる。
  3. 履歴の参照に一致するものが無い。
    !! や !123 は、履歴に無いと zsh: no such event: 123 のような別の文言になる。
    履歴があれば、echo "!!" は直前のコマンドに置き換わって実行される。

このエラーは対話シェルでしか出ない。
zsh script.zsh と zsh -c では、echo "hello!world" はそのまま hello!world を出した。
[[ a != b ]] や [[ ! -f file ]] も、展開されずに動いた。

bash でも echo "hello!world" は bash: !world: event not found になり、エラーには ! も含めて出る。
echo "hello!" は bash ではそのまま hello! と出力され、dquote> で止まるのは zsh だけである。