仕事用のマシンをM1 MacBook Proに交換してもらったので、開発環境を整え直しました。

2年ほど fish を使ってきたのだけれど、普段は良いのだけれど、ちょっと自動化したくなったときに、やはりPOSIX準拠じゃないシェルはなかなか難しかった。macOSの標準も zsh になったことだし、久しぶりに戻ってみることにした。

導入

現代なので XDG Base Directory Specification に乗っかっておくことにする。
Arch Linux の Wiki がよくまとまっていて助かるのでこれを参考にして進めた。

zshの場合は ZDOTDIR を指定するといいのだけれど、これをどこで指定するのかという問題がある。zshの起動時に最初に読み込まれるユーザー設定は ~/.zshenv なのだけれど、ここに ZDOTDIR を書くということは .zshenv だけホームディレクトリに残ってしまう。これはちょっと気持ち悪い。

あんまり嬉しくはないのだけれど、諦めて /etc/zshenv に書くことにします。

ZDOTDIR=
$HOME
/.config/zsh

これで zsh のユーザー毎の設定ファイルは ~/.config/zsh から読まれることになります。(仕事用の macOS だし自分しかユーザーはいないしまあいいでしょ)

次に仕様に沿った環境変数を ~/.config/zsh/.zshenv 設定していきます。
特にひねることはないので推奨のディレクトリにしておきます。
(GOPATH を ~/local に ghq のルートディレクトリを ~/local/src にしているので ~/.local はちょっと気持ち悪くはあります。)

export
 XDG_CONFIG_HOME=
"
$HOME
"
/.config
export
 XDG_CACHE_HOME=
"
$HOME
"
/.cache
export
 XDG_DATA_HOME=
"
$HOME
"
/.
local
/share
export
 XDG_STATE_HOME=
"
$HOME
"
/.
local
/state

はい、これで基本的な準備は整いました。

zsh は最新のものを使いたいので Homebrew でインストールしておきます。

$ brew install zsh

Zim

zsh をそのまま使うなんてことは出来ないので、設定をごりごり書いていきたい訳ですが、最近はもう自分で設定を書くのは面倒になっています。
もうちょっと若いときは無限に設定ファイルを触っていられたのですが、こうやってどんどん新しいことを学べなくなっていくのです。

設定なしに良い感じになって、かつ Oh My Zsh の遅さに辟易としていたのでとにかく速いのを探しました。

いくつか見て回って Zim が良さそうだったのでこれを導入します。

導入は最近よく見る curl を叩くやつ。

$ curl -fsSL https://raw.githubusercontent.com/zimfw/install/master/install.zsh 
|
 zsh

.zshrc にいくつか設定が書き込まれます。よく見ると設定が読み込まれたときにさらに本体のダウンロードを行うようです。

なんとこれだけでまあまあ良い感じに動きます。そして起動が速い！！！

asciiship という Spaceship や Starship を ASCII 文字だけで表現したテーマがデフォルトになっているのですが、もうこれでいいや感があったのでそのままにしています。どんどんこだわりが失われていっている。

他にもテーマがあったり、公式のモジュールもあるので ドキュメント を参照してください。

その他の設定

履歴ファイルの設定だけ .zshenv に書いても効いてくれなかったので以下のように .zshrc に書きました。
zim が上書きしている感じなのですが、設定済なら無視するように書かれているように見えるので多分何かを間違っているだけなはず。しかし調べる元気がない。

export
 HISTFILE=
"
$XDG_DATA_HOME
"
/zsh/
history

あとは cdr とか AUTO_CD 周りの設定を少し書いた。
AUTO_CD 自体は Zim が有効にしてくれている。

 
autoload
 -Uz chpwd_recent_dirs cdr add-zsh-hook
add-zsh-hook chpwd chpwd_recent_dirs
zstyle
 
':completion:*:*:cdr:*:*'
 menu selection
zstyle
 
':chpwd:*'
 recent-dirs-max 
100
zstyle
 
':chpwd:*'
 recent-dirs-default 
true
zstyle
 
':chpwd:*'
 recent-dirs-insert 
true
zstyle
 
':chpwd:*'
 recent-dirs-file 
"
$XDG_DATA_HOME
"
/zsh/chpwd-recent-dirs

 
cdpath=(~ ..)

u というリポジトリのルートディレクトリに移動する関数を書いておく。
これはたしか ujihisa さんの設定から持ってきたのをずっと使っている気がする。
今回は補完関数も書いたけど、そこまで便利じゃないしバグがある。

function
 u() {
  
cd
 ./
"
$(
git rev-parse --show-cdup
)
"
  
if
 [ 
$#
 = 
1
 ]; 
then
    
cd
 
"
$1
"
  
fi
}
_u() {
  _values 
$(
fd --type d --base-directory 
$(
git rev-parse --show-cdup
))
}
compdef _u u

fishで一番良かったのが abbr だったと思うので、これを zsh でも再現させたい。
abbr は alias とは違って、省略形のコマンドを入力すると省略しない形に展開してくれるやつ。
g って入力してスペース打つと git に展開してくれる。
alias を覚えるのがつらくなってきたので展開してくれる方が元のコマンドに紐付けて覚えるので助かる。

zsh で同じ機能を実現するのに zsh-abbr が使えるのでこれを導入した。

zim にはプラグイン機構もあるのでこれを使って導入する。

$DOTDIR/.zimrc に以下の一行を加えて zimfw install というコマンドを打つだけ。

zmodule olets/zsh-abbr

これで導入が完了するので設定していく。abbr コマンドを使っても設定できるが $DOTDIR/abbreviations に書いておくと一括で指定出来る。
僕は以下のようにしている。

abbr b=
"bundle"
abbr be=
"bundle exec"
abbr d=
"docker"
abbr dc=
"docker compose"
abbr di=
"git diff"
abbr e=
"exit"
abbr g=
"git"
abbr gd=
"git diff --cached"
abbr ggrep=
"git grep"
abbr gl=
"git log"
abbr gr=
"git restore"
abbr gs=
"git switch"
abbr l=
"git log"
abbr p=
"git pull"
abbr pick=
"git cherry-pick"
abbr pop=
"git stash pop"
abbr s=
"git status -sb"
abbr st=
"git stash"

fzf

これまではコントリビュートする程度には peco を使ってきたのですが、気分を変えようと fzf に移行しました。
なんか勝手に重いイメージだったけれど、別にそんなことはなかった。
fzf は preview が出せるのが見た目が良くて楽しい。

導入はREADMEに従って Homebrew でインストールした。

$ brew install fzf
$ $(brew --prefix)/opt/fzf/install

補完の設定が生成されるので、それを .zprofile とかで読み込んでおく。

[ -f ~/.fzf.zsh ] && 
source
 ~/.fzf.zsh

ここまですると Ctrl-r で zsh の履歴検索、 Ctrl-t でカレントディレクトリ以下のファイル検索が fzf 経由で出来るようになる。

モダンなコマンド達と組み合わせるために fzf module を追加しておく。
モダンなコマンドというのは fd と bat のことです。

zmodule fzf

$DOTDIR/.zimrc に追加して zimfw install する。

これでファイルの検索が爆速になるし、プレビューがカラフルで見やすくなる。

あとは良い感じのをいくつか定義しておく。

まずはデフォルトの設定を .zshenv に書いておく。peco のデフォルトに慣れているので --layout=reverse だけは外せない。あとはお好みで。

export
 FZF_DEFAULT_OPTS=
'--layout=reverse --border --exit-0'

最近はほとんどを VSCode の中で過ごしているので使う機会は限られているのだけれど、必要そうなのを書いておく。

ghqでリポジトリを選んで移動するやつ。最低限これさえ出来ればあとはどうでもいい。

fzf-ghq() {
  
local
 repo=
$(
ghq list 
|
 fzf --preview 
"ghq list --full-path --exact {} | xargs exa -h --long --icons --classify --git --no-permissions --no-user --no-filesize --git-ignore --sort modified --reverse --tree --level 2"
)
  
if
 [ -n 
"
$repo
"
 ]; 
then
    repo=
$(
ghq list --full-path --exact 
$repo)
    BUFFER=
"cd 
${repo}
"
    
zle
 accept-line
  
fi
  
zle
 clear-screen
}
zle
 -N fzf-ghq
bindkey
 
'^[s'
 fzf-ghq

プルリクを検索しつつそのブランチに switch するやつ。
仕事では JIRA を使っていて、ブランチ名をチケットの番号にしているので目的のブランチを探すのが大変なことがある。
そんな時にはプルリクから検索して切り替えられると便利なので追加した。
gh が必要なのでインストールしておきましょう。
最近 id:shiba_yu36 さんが pecoで似たようなこと をされていた

fzf-pullreq() {
  
local
 pullreq=
$(
CLICOLOR_FORCE=
1
 GH_FORCE_TTY=
100
% gh pr list 
|
 tail -n
+4
 
|
 fzf --ansi --bind 
"change:reload:CLICOLOR_FORCE=1 GH_FORCE_TTY=100% gh pr list -S {q} | tail -n+4 || true"
 --disabled --preview 
"CLICOLOR_FORCE=1 GH_FORCE_TTY=100% gh pr view {1} | bat --color=always --style=grid --file-name a.md"
)
  
if
 [ -n 
"
$pullreq
"
 ]; 
then
    pullreq=
$(
echo
 
$pullreq
 
|
 awk 
'{ print $1 }'
)
    BUFFER=
"gh pr checkout 
\"
${pullreq}
\"
"
    
zle
 accept-line
  
fi
  
zle
 clear-screen
}
zle
 -N fzf-pullreq
bindkey
 
'^[p'
 fzf-pullreq

Git のブランチを切り替えるやつ。特におもしろみはない。

 
fzf-branch() {
  
local
 format=
"\
%(color:yellow)%(refname:short)%(color:reset)|\
%(color:bold red)%(objectname:short)%(color:reset) \
%(color:bold green)(%(committerdate:relative))%(color:reset) \
%(color:bold blue)%(authorname)%(color:reset) \
%(color:yellow)%(upstream:track)%(color:reset)|\
%(contents:subject)"

  
local
 branch=
$(
git for-each-ref --color=
always
 --sort=-committerdate 
"refs/heads/"
 --format=
"
$format
"
 
|
 column -ts 
"|"
 
|
 fzf --preview 
"git log --color {1}"
)
  
if
 [ -n 
"
$branch
"
 ]; 
then
    branch=
$(
echo
 
$branch
 
|
 awk 
'{ print $1 }'
)
    BUFFER=
"git switch 
${branch}
"
    
zle
 accept-line
  
fi
  
zle
 clear-screen
}
zle
 -N fzf-branch
bindkey
 
'^[b'
 fzf-branch

前半で設定した cdr のディレクトリを選択して移動できるやつ。

 
fzf-cdr(){
    
local
 dir=
$(
cdr -l 
|
 fzf --preview 
'f(){ zsh -c "exa -h --long --icons --classify --git --no-permissions --no-user --no-filesize --git-ignore --sort modified --reverse --tree --level 2 $1" }; f {2}'
)
    
if
 [ -n 
"
$dir
"
 ]; 
then
        dir=
$(
echo
 
$dir
 
|
 awk 
'{ print $1 }'
)
        BUFFER=
"cdr 
${dir}
"
        
zle
 accept-line
    
fi
    
zle
 clear-screen
}
zle
 -N fzf-cdr
bindkey
 
'^[r'
 fzf-cdr

しれっと exa を使っているのでこれもインストールしておきましょう。
ls などを exa に読み替えてくれるモジュールがあるのでこれも入れておく。いつも通り .zimrc に追加して zimfw install です。

zmodule exa

ls の 挙動 をちょっと弄りたかったので以下のようにしています。

alias
 ls=
'exa --classify --icons -h --reverse'

これで fzf を最低限は使えるようになりました。

この記事は Cornelius で書きました。