> For the complete documentation index, see [llms.txt](https://yutakatay.gitbook.io/katapedia/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://yutakatay.gitbook.io/katapedia/doc/zsh.md).
# Zsh
## bindkey
### カーソル移動のキーバインド
カーソルを1文字分戻す
zsh backward-char CTRL+B
カーソルを1文字分進める
zsh forward-char CTRL+F
行頭にカーソルを移動
zsh beginning-of-line CTRL+A
行末にカーソルを移動
zsh end-of-line CTRL+E
次のワードに移動
zsh forward-word ESC f または M-f
前のワードに移動
zsh backword-word ESC b または M-b
### 一文字削除
カーソル前の文字を削除
zsh backward-delete-char CTRL+H または DEL
カーソル位置に文字があればそれを削除
なければファイル名補完のリストを表示
zsh delete-char-or-list CTRL+D
### 単語削除
前方 CTRL+w
後方 Alt+d
### 削除/復帰-
前のワードを消去
zsh backward-kill-word CTRL+W または ESC CTRL+H
ワードを消去
zsh delete-word ESC d
入力行全部を消去
zsh kill-whole-line CTRL+U
カーソル位置から行末まで消去
zsh kill-line CTRL+K
マークセット
zsh set-mark-command CTRL+@
カーソルとマークを入れ換える
zsh exchange-point-and-mark CTRL+X CTRL+X
消去した文字列をカーソル位置に挿入
zsh yank CTRL+Y
領域をコピーするが削除はしない
zsh copy-region-as-kill ESC w
### 編集
#### エディタでコマンドを編集
autoload -U edit-command-line zle -N edit-command-line bindkey '^xe' edit-command-line bindkey '^x^e' edit-command-line
`fc`でもいける
### ヒストリ機能
複数行のときは上の行にカーソルを移動する。そうでないときは、前のヒストリを現在の入力行にする。
zsh up-line-or-history CTRL+P
複数行のときは下の行にカーソルを移動する。そうでないときは、次のヒストリを現在の入力行にする。
zsh down-line-or-history CTRL+N
ヒストリの中を後にサーチする
zsh history-search-backward ESC p
ヒストリの中を後にインクリメンタルサーチをする
zsh history-incremental-search-backward CTRL+R または CTRL+X r
ヒストリの中を前にサーチする
zsh history-search-backward ESC p
ヒストリの中を前にインクリメンタルサーチをする
zsh history-incremental-search-forward CTRL+S または CTRL+X s
csh のヒストリを実際に展開する。
zsh expand-history ESC ! または ESC SPACE
複数行のときは先頭にカーソルを移動する。そうでないときは、ヒストリの先頭を現在の入力行にする。
zsh beginning-of-buffer-or-history ESC <
複数行のときは最後にカーソルを移動する。そうでないときは、ヒストリの最後を現在の入力行にする。
zsh end-of-buffer-or-history ESC >
現在のコマンドを実行して、そのコマンドが終了したら、ヒストリの次のコマンドをコマンドラインに出す。ヒストリの次のコマンドがないときは、現在のコマンドも実行されない。
zsh accept-line-and-down-history CTRL+O
ヒストリに登録するのを、入力行そのままかシェルによって処理された後の行にするかをきりかえる。
zsh toggle-literal-history ESC r または M-r
### 補完機能
補完するか、globbing(ワイルドカード)などを展開する。
zsh expand-or-complete CTRL+I
カーソル位置に文字があればそれを削除なければ補完のリストを表示
zsh delete-char-or-list CTRL+D
ワードを展開する(globbingや変数など)
zsh expand-word CTRL+X \*
globbing を展開したリストを表示する
zsh list-expand CTRL+X g
補完リストの表示
zsh list-choices ESC CTRL+D
## 補完機能の拡張
## Tips
### 起動方法とZSH\_EVAL\_CONTEXTの関係
### zshでcdlsするときに関数とaliasを使わずにchpwdを使う理由
AUTO\_CDのときに使えなくなるため
（AUTO\_CDとはcdを打たずにディレクトリ名だけで移動できる機能）
あとはpushdとかでも適用されなくなる。
### 遅いときの調査方法
.zshenv 行頭 に次の処理を追記
zmodload zsh/zprof && zprof
.zshrc 行末 に次の処理を追記
if (which zprof > /dev/null) ;then
zprof | less
fi
### コマンドの一時保存
* Ctrl+Y will paste the last item you cut (with Ctrl+U, Ctrl+K, Ctrl+W, etc.).
* Esc q
* Ctrl+q
* Ctrl-A
Enter
\
* Esc #
* Alt #
### コマンド、関数があるか調べる
if whence anyframe-widget-put-history > /dev/nul; then
fi
### lsで絶対パスを取る方法
ls ../test.txt(:a)
### デフォルトで使える色
black
red
green
yellow
blue
magenta
cyan
white
### プロンプトの設定
これらはデフォルト値なので必要ない。
```
PROMPT2='%_> ' # などでコマンドを改行で続けたとき
PROMPT3='?# ' # switch文時
PROMPT4='+%N:%i> ' # シェルスクリプトデバッグ時
SPROMPT="%r is correct? [n,y,a,e]: " # 入力ミスの時に出る
```
#### プロンプトをあれこれいじくり回したいときに参照するページ
#### 動的文字を挿入したい
zle -R を使う
### oh-my-zsh
インストール
`wget http://github.com/robbyrussell/oh-my-zsh/raw/master/tools/install.sh ~~O ~~ | sh`
## スクリプト
### フラグとか変数展開とかの記号の意味
## TroubleShooting
### 補完が遅いコマンドがあるときに無効にしたい
compdef -d
### コマンド履歴ファイルが読み込まれない
どのタイミングで発生しているかは不明
`fc -R`
### マニュアルインストールしたzshでfpathが正しく定義されない
`./configure --enable-additional-fpath=/usr/local/share/zsh/site-functions,/usr/share/zsh/vendor-functions,/usr/share/zsh/vendor-completions,/usr/share/zsh/functions/Calendar,/usr/share/zsh/functions/Chpwd,/usr/share/zsh/functions/Completion,/usr/share/zsh/functions/Completion/AIX,/usr/share/zsh/functions/Completion/BSD,/usr/share/zsh/functions/Completion/Base,/usr/share/zsh/functions/Completion/Cygwin,/usr/share/zsh/functions/Completion/Darwin,/usr/share/zsh/functions/Completion/Debian,/usr/share/zsh/functions/Completion/Linux,/usr/share/zsh/functions/Completion/Mandriva,/usr/share/zsh/functions/Completion/Redhat,/usr/share/zsh/functions/Completion/Solaris,/usr/share/zsh/functions/Completion/Unix,/usr/share/zsh/functions/Completion/X,/usr/share/zsh/functions/Completion/Zsh,/usr/share/zsh/functions/Completion/openSUSE,/usr/share/zsh/functions/Exceptions,/usr/share/zsh/functions/MIME,/usr/share/zsh/functions/Misc,/usr/share/zsh/functions/Newuser,/usr/share/zsh/functions/Prompts,/usr/share/zsh/functions/TCP,/usr/share/zsh/functions/VCS_Info,/usr/share/zsh/functions/VCS_Info/Backends,/usr/share/zsh/functions/Zftp,/usr/share/zsh/functions/Zle`
をする
### \_unsetopt: function definition file not found
rm \~/.zcompdump
### PATHが相対パスだとパスが通らない
bashでは相対パスでもうまくいくのにzshではダメな模様
readlink -fして絶対パスに直すこと
## プラグイン
* auto-fu.zsh
* antigen
クソ便利！
良さそうなやつ
* zsh-syntax-highlight
* cd-gitroot
* cd-bookmark
* cdd
* knu/z
* zsh-bd
* incr
* zsh-autosugestions
* zsh-history-substring-search
* zsh-git
* zaw
* prezto
## FAQ
#### PATHに記載されている(N-/)とは
(N-/): 存在しないディレクトリは登録しない。
#### chpwdを一時的に無効にしたい
cd -qで実行する
#### 補完時にGet : dial unix /var/run/docker.sock: permission deniedとか表示される
usermod -G docker -a your\_user\_name.
再起動でエラーが表示されなくなる。（dockerサービス再起動ではうまくいかなかった）
#### 新しいコマンドが補完されない
補完のインデックスが更新されていないため
rehash or hash -rf.をうつ
または、
zstyle ":completion:\*:commands" rehash 1
を.zshrcに書く。
パフォーマンスが悪くなるが。。。
#### autoload -Uzの意味
#### compinit -u の意味
セキュリティのために、compinitは以下のことをチェックします。
・補完システムが使用するファイルの所有者がrootか現在のユーザ以外であるか
・ファイルが入っているディレクトリ
・パーミッション：誰でも書き込み可能もしくはグループ書き込み可能か
・rootもしくは現在のユーザ以外が所有しているか
-u : 上記のテストを避けて、すべての発見したファイルを警告なしに使用する
## バグ
#### ctrl+backspace
ctrl+backspaceがgnome-terminalのバグでbackspaceと同じkeycode ^?となってしまう。
teratermからは可能だが、しばらくはctrl+wで我慢するしかない。。。
#### 5.0.2の履歴（ヒストリー）バグ
これが
```
sudo estcmd gather -il -ja -cm -fx ".pdf" "H@/usr/share/hyperestraier/filter/estfxpdftohtml" /opt/redmine/files/dmsf_index -lt -1
```
こうなる
```
sudo estcmd gather -il ja cm fx ".pdf" "H@/usr/share/hyperraier/filter/stfxpdftohtml" /opt/redmine/flles/dmsf_index /opt/rede/filllles/dmsf pc ut--8 lf -
```
~~5.0.5をソースインストールしたら改善されていた。~~
auto-fuのバグが原因。auto-fuをアップデートしたらOK
#### 5.0.2の履歴（ヒストリー）バグ2
setopt hist\_reduce\_blanksが有効だと
vi -u .vimrc --startuptime aaa .vimrc
が
vi -u .vimrc --startuptime aaa .vmmrc
こうなる
## リンク
"oh-my-zshテーマ":
"oh-my-zshプラグイン":
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://yutakatay.gitbook.io/katapedia/doc/zsh.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.