6 年 8 ヶ月お世話になった Bash から Zsh に移行した (移行変更点まとめ)
はじめに
先日 Bash から Zsh に移行しました。
noraworld/dotfiles で管理する前から使っているので、その期間も含めると 6 年 8 ヶ月の間、Bash にお世話になりました。
移行のきっかけ
そもそも前々から Zsh や Fish が使いやすいという話は聞いていたのでいずれ移行しようとは思っていました。しかし、4 〜 5 年近く bashrc や bash_profile を醸造していたので、他のシェルに移行するのが億劫になっていました。
そんな期間が長く続いたのですが、ついに Zsh に移行することにしました。きっかけとしては、
- Bash に Zsh や Fish のようなプラグインマネージャがないのがすごく不便に感じていた
- Homebrew などで管理されていないスクリプトを dotfiles で管理しようとすると、そのスクリプトをそのまま置くしかない
- Bash-Preexec など
- Bash-Preexec が正常に機能しない
-
Starship の一部の機能が正常に機能しない
- おそらく Bash-Preexec が原因
あたりです。今後もシェルの環境は定期的に見直して便利にしていきたいと思っていて、Bash のままカスタマイズし続けるのにそろそろ限界を感じていました。
Fish にしなかった理由
はじめは Fish を使おうと思っていました、実際インストールして軽く試してみました。デフォルトで良い感じにしてくれるというのに魅力を感じたからです。
しかし、Fish は POSIX 非互換なため、4 〜 5 年間、醸造した bashrc や bash_profile を Fish に移行するのは大変そうだという理由で Zsh を選びました。
この記事について
「Bash から Zsh に移行する」系の記事を見ていると、単に bashrc や bash_profile を zshrc や zprofile にコピーするだけという説明が多かったのですが、自分の環境だと、ただコピーしただけでは動かない部分が多かったです (Bash 固有の記法や仕様を使っているので当然なのですが)。
そのため、この記事ではぼくの dotfiles (noraworld/dotfiles) で Bash から Zsh に移行するに当たって変更が必要だった部分を紹介します。
記事を読む前にざっくりと変更点 (差分) を知りたい方は、以下のコミット履歴を参考にしてください。
The default shell is now changed to Zsh from Bash · noraworld/dotfiles@a0a5281
変更点
ざっと書いていきます。
カレントシェルで動作するスクリプトから Bash 依存の記法を削除する
自分で作ったシェルスクリプト (Bash) にパスを通して使っている場合、そのすべてを Zsh に移行する必要はありません。shebang を Bash にしておけば、インタラクティブシェルは Zsh のままに、Bash としてそのシェルスクリプトを動かすことができるからです。たいていの場合はそれで問題ありません。
ところが、カレントシェルとして実行させるシェルスクリプトの場合は、Zsh で動作するように書き換える必要があります。たとえばぼくの場合、mkcd という数行のシェルスクリプトをおいています。
mkdir $1
if [[ -d $1 ]]; then
cd $1
fi
このシェルスクリプトは、引数に指定した名前でディレクトリを作り、同時にそのディレクトリに移動までしてくれます。カレントシェルで移動する必要があるので、このスクリプトはカレントシェルで動作するようにしています。
この場合は当然 Zsh で正常に動かなければ意味がないので、もし Bash 固有の記法 (Zsh では動作しない記法) を使っている場合は書き換える必要があります。
ちなみに上記で説明した mkcd
コマンドは単純すぎてどこも修正する必要はありませんでした。
また、このようなカレントシェルで動作させるスクリプトでは、shebang は消しておいたほうが良いかもしれません。
ビルトインコマンドの挙動による違いに注意する
ビルトインコマンドとは、シェルに組み込まれているコマンドのことです。どこかのパスに置かれているコマンドとは異なり、シェル内部で持つコマンドなので、シェルの種類によって挙動が異なる場合があります。
たとえば history
や dirs
、pushd
、popd
などが該当します。
ビルトインコマンドなのかどうかは type
コマンドで調べられます。
$ type history
history is a shell builtin
$ type dirs
dirs is a shell builtin
$ type pushd
pushd is a shell builtin
$ type popd
popd is a shell builtin
重要なのは Bash と Zsh でビルトインコマンドの挙動が異なる場合があることです。たとえば Bash の場合、history
コマンドを実行すると全件表示されますが、Zsh の場合、デフォルトだと最新の 16 件のみが表示されます。
もし自分で作ったシェルスクリプトやエイリアスで、history
のような挙動の異なるコマンドを使用している場合は、これらの仕様の違いについても考慮する必要があります。
dirs コマンドの引数について
ビルトインコマンドの挙動の違いに関して、ぼくが遭遇したのは dirs
コマンドの引数です。
Bash だと +N
(N
は数値) を指定すると N 番目のディレクトリスタックを取得できるのですが、Zsh だとそれができませんでした。
$ dirs -l -v
0 /Users/noraworld/Workspace
1 /Users/noraworld/Workspace/dotfiles/bin/src
2 /Users/noraworld/Workspace/dotfiles/bin/src/currentshell
3 /Users/noraworld
$ dirs -l -v +0
0 /Users/noraworld/Workspace
$ dirs -l -v
0 /Users/noraworld/Workspace
1 /Users/noraworld/Workspace/dotfiles/bin/src
2 /Users/noraworld/Workspace/dotfiles/bin/src/currentshell
3 /Users/noraworld
$ dirs -l -v +0
0 /Users/noraworld/Workspace
1 /Users/noraworld/Workspace/dotfiles/bin/src
2 /Users/noraworld/Workspace/dotfiles/bin/src/currentshell
3 /Users/noraworld
ぼくの環境では dirs -l -v +0
を使っていたので dirs -l -v | head -1
に置き換えました。[差分]
command
コマンドを使用しない
ビルトインコマンドに対して 詳しいことはわかりませんが、Zsh ではビルトインコマンドに対して command
コマンドが使用できないようです。
$ command history
# history が表示される
$ command history
zsh: command not found: history
そのため、自分で作ったスクリプト内でビルトインコマンドに対して command
コマンドを使用している場合は、使用しないように書き換えてください。[差分]
.bashrc ではなく .zshrc をロードする
ここは特に説明不要だと思います。ただし書き直し忘れがありそうなので一応記載します。
- if [ -f ~/.bashrc ]; then
- . ~/.bashrc
- fi
+ if [ -f ~/.zshrc ]; then
+ . ~/.zshrc
+ fi
Bash 用のスクリプトをロードしない
これも自明なのですが念のため書いておきます。Bash completion や Bash-Preexec などを入れている場合は Zsh では削除してください。以下はぼくの環境の例です。
- if [ -e /usr/local/etc/bash_completion.d/git-prompt.sh ]; then
- . /usr/local/etc/bash_completion.d/git-prompt.sh
- fi
- if [ -e /usr/local/etc/bash_completion.d/git-completion.bash ]; then
- . /usr/local/etc/bash_completion.d/git-completion.bash
- fi
- if [ -e /usr/local/etc/bash_completion.d/git-prompt.sh ]; then
- GIT_PS1_SHOWDIRTYSTATE=true
- fi
- [[ -f ~/.bash-preexec.sh ]] && source ~/.bash-preexec.sh
- if [ -f `brew --prefix`/etc/bash_completion ]; then
- . `brew --prefix`/etc/bash_completion
- fi
ちなみに Bash だと Bash completion を入れないと SSH のホストの補完や Git のサブコマンドの補完を行ってくれませんが、Zsh だとデフォルトで補完してくれるようです。
$PROMPT_COMMAND
で実行するコマンドを precmd()
に移行する
Bash では $PROMPT_COMMAND
という環境変数にコマンドを入れておくと、コマンドの実行直後 (正確には、新しいプロンプトが表示される直前) に $PROMPT_COMMAND
内のコマンドを毎回実行してくれます。
Zsh では $PROMPT_COMMAND
の代わりに precmd()
という関数を作って、その中に実行したいコマンド (処理) を書きます。
- if ! [[ "$PROMPT_COMMAND" =~ "<YOUR_COMMAND>" ]]; then
- PROMPT_COMMAND="<YOUR_COMMAND>;$PROMPT_COMMAND"
- fi
+ precmd() {
+ <YOUR_COMMAMD>
+ }
あるいは、$PROMPT_COMMAND
をそのまま残しつつ、eval
コマンドを使って以下のように書くこともできます。
if ! [[ "$PROMPT_COMMAND" =~ "<YOUR_COMMAND>" ]]; then
PROMPT_COMMAND="<YOUR_COMMAND>;$PROMPT_COMMAND"
fi
+
+ precmd() {
+ eval "$PROMPT_COMMAND"
+ }
参考: What's the ZSH equivalent of BASH's $PROMPT_COMMAND?
もっとも、$PROMPT_COMMAND
の代わりに Bash-Preexec を使っていた場合は、単に Bash-Preexec をロードしないようにするだけで OK です。Bash-Preexec の preexec()
と precmd()
は、trap DEBUG
や $PROMPT_COMMAND
を使って Zsh のそれらを真似たものなので、関数名を変更する必要はありません。
- [[ -f ~/.bash-preexec.sh ]] && source ~/.bash-preexec.sh
-
preexec() {
<YOUR_PROCESSING>
}
precmd() {
<YOUR_PROCESSING>
}
イニシャルスクリプトをロードしている部分を Bash から Zsh に変える
ツールによっては ~/.bashrc
や ~/.zshrc
にイニシャルスクリプトをロードするように指示されている場合があります。それが Bash 用のものであれば Zsh に置き換えてください。
たとえば Starship や direnv を使っている場合は以下のように置き換えます。
- eval "$(starship init bash)"
+ eval "$(starship init zsh)"
- eval "$(direnv hook bash)"
+ eval "$(direnv hook zsh)"
==
を =
に置き換える
等価を表す記号に ==
が使えるのは Bash のみです。もし ==
が使われていたら =
に置き換えてください。以下は例です。[差分]
- if [ "$TERM_PROGRAM" == "iTerm.app" ]; then
+ if [ "$TERM_PROGRAM" = "iTerm.app" ]; then
参考: シェルスクリプトでの == を認めているのはbashだけ?
$EPOCHREALTIME
を使っている場合は zsh/datetime
モジュールをロードする
$EPOCHREALTIME
は UNIX 時間を浮動小数点数で取得するための環境変数です。
Bash ではそのまま使えますが、Zsh では zsh/datetime
をロードする必要があります。もし ~/.zshrc
内で $EPOCHREALTIME
を使用している場合は、$EPOCHREALTIME
使用箇所より前に以下を追加します。
+ zmodload zsh/datetime
参考: Zsh で $EPOCHREALTIME を使いたい
bindkey -e
を追加する (Ctrl
キーを Bash と同じキーバインドで使用したい場合)
Ctrl
+ A
でコマンドの行頭に移動、Ctrl
+ E
で行末に移動、Ctrl
+ P
で一つ前のコマンド履歴を表示、Ctrl
+ N
で一つ先の履歴を表示、などのキーバインドが、Bash ではデフォルトで有効でしたが、Zsh だと ^A
、^E
、^P
、^N
のように表示されてしまいます。
上記のキーバインドを有効にするには以下を追加します。
+ bindkey -e
ちなみに bindkey -e
の代わりに bindkey -v
とすると Vim 風のキーバインドにできます。-e
は Emacs 風、-v
は Vim 風ということですね。
つまり Bash は (おそらく Fish も) デフォルトでは Emacs 風のキーバインドになっているということです。
set completion-ignore-case on
を入れている場合は以下に置き換える
.inputrc に Bash では ~/.inputrc
に以下を追加することで大文字小文字を無視することができます。
+ set completion-ignore-case on
Zsh ではこれでは大文字小文字が無視されないので、代わりに以下を ~/.zshrc
に追加します。
+ autoload -Uz compinit && compinit
+ zstyle ':completion:*' matcher-list 'm:{a-z}={A-Z}'
ちなみにこれは、たとえばカレントディレクトリに Workspace
(W
は大文字) というディレクトリがあったときに cd work
(w
は小文字) とタイプしてタブキーで補完すると cd Workspace
のように W
が自動的に大文字に変換される機能です。
そもそも大文字小文字はファイル名やディレクトリ名では区別されない (大文字小文字のみが異なる同名のファイルやディレクトリは作れない) ので大文字小文字は無視して補完してくれたほうが便利です。
正規表現をクォーテーションで囲む
Bash では OK で、Zsh では NG の理由がよくわからないのですが、Zsh だと正規表現をクォーテーションで囲まないとエラーになります。[差分]
$ echo 550.5154612064 | sed s/\.[0-9,]*$//g
550
$ echo 550.5154612064 | sed 's/\.[0-9,]*$//g'
550
$ echo 550.5154612064 | sed s/\.[0-9,]*$//g
zsh: no matches found: s/.[0-9,]*$//g
$ echo 550.5154612064 | sed 's/\.[0-9,]*$//g'
550
正規表現をクォーテーションで囲っていない部分があれば囲みましょう。
まとめ
ぼくの環境では以上のような変更点がありました。まだ他にも、Bash から Zsh に移行する際に必要な変更点があるかもしれませんが、この記事が Bash から Zsh への移行の助けになれば幸いです。
Discussion