Mac
PR

Macのzsh設定ファイル(.zshrc・.zprofile・.zshenv)の違いとPATH・エイリアスの設定

Macのzsh設定ファイル(.zshrc・.zprofile・.zshenv)の違いとPATH・エイリアスの設定
hr
記事内に商品プロモーションを含む場合があります

Mac で「~/.zshrc に PATH を書いてください」と言われる一方で、別の手順書には「~/.zprofile に書く」とある。.zshenv というファイルもあるらしい。どれに書けばよいのか、なぜ書いたのに効かないのか、で迷う人は多いはずです。

この記事では、Mac の標準のシェル(コマンドを受け取って実行するプログラム)である zsh の設定ファイルについて、読み込まれる順番と条件、Mac だけにある PATH の並べ替えのしくみ(path_helper)、PATH・エイリアス・関数の書き方、反映のしかた、bash からの移行を説明します。ターミナルの基本的な使い方や Windows のコマンドとの対応は「WindowsユーザーのためのMacのターミナル入門|コマンドプロンプト・PowerShellとの対応表」で説明しているので、ここでは設定ファイルを詳しく扱います。

この記事の内容は、2026 年 11 月 1 日に確認した zsh の公式マニュアル(zsh.sourceforge.io、zsh 5.9.2 の版)、Apple のサポート記事・ターミナルユーザガイド・開発者向け資料、Apple が公開している macOS のソースコード(apple-oss-distributions)にもとづきます。この記事を書いた環境には Mac がないため、Mac で実行した結果の例は載せていません。コマンドの書き方はマニュアルの記述にそろえています。お使いの Mac の zsh の版によって細かい違いがありうるので、気になるときはターミナルで man zsh と打って手元の説明も確かめてください。

結論:何をどのファイルに書くか

先に結論をまとめます。理由はこのあと順に説明します。

ファイル読み込まれるとき書くもの
~/.zshenvzsh が起動するたび(スクリプトの実行も含む)基本は何も書かない。書くなら、どの zsh でも必要な最小限の環境変数だけ。PATH はここに書かない(後で説明する path_helper に順番を変えられる)
~/.zprofileログインシェルのときPATH や環境変数(export)。Homebrew のように、インストーラーがここに書くよう案内するもの
~/.zshrc対話シェル(人がコマンドを打つシェル)のときエイリアス、関数、プロンプト、補完、シェルのオプション。PATH をここに書いても、ターミナルで使う分には効く
~/.zloginログインシェルのとき(~/.zshrc の後)ふだんは使わなくてよい
~/.zlogoutログインシェルが終わるときふだんは使わなくてよい

Apple のサポート記事「zshをMacのデフォルトシェルとして使う」では、.zprofile は bash の .bash_profile にあたり「ログイン時(SSH ログインも含む)に実行」、.zshrc は .bashrc にあたり「新しいターミナルのセッションごと」に実行されると説明されています。

設定ファイルが読み込まれる順番

zsh の公式マニュアル「Files」(5.1 Startup/Shutdown Files)によると、zsh は起動したときに次の順で設定ファイルを読み込みます。/etc/ のファイルはそのコンピュータの全ユーザー共通の設定、~(ホームフォルダ)のファイルは自分だけの設定です。

  1. /etc/zshenv:必ず読まれる(止められない)
  2. ~/.zshenv:必ず読まれる
  3. /etc/zprofile → ~/.zprofile:ログインシェルのときだけ
  4. /etc/zshrc → ~/.zshrc:対話シェルのときだけ
  5. /etc/zlogin → ~/.zlogin:ログインシェルのときだけ

ログインシェルが終わるとき(exit や logout、Control+D で終えたとき)は、~/.zlogout → /etc/zlogout の順に読まれます。ただし exec でほかのプログラムに置き換わって終わったときは読まれません。

同じマニュアルには、次のことも書かれています。

  • ホームフォルダのファイルは、正確には $ZDOTDIR というフォルダから読まれる。ZDOTDIR を設定していなければホームフォルダ($HOME)が使われる
  • /etc のファイルは、インストールのしかたによっては別のフォルダにあることがある
  • zsh -f のように -f を付けて起動すると、/etc/zshenv 以外の設定ファイルは読まれない(オプション RCS がオフになる。マニュアル「Options」)

Mac の場合、Apple が公開している zsh のソースコード(apple-oss-distributions/zsh)には、共通の設定ファイルとして zprofile と zshrc の 2 つが入っていて、インストール時に /etc(正確には /private/etc)に置く作りになっています。/etc/zshenv と /etc/zlogin はこのソースには含まれていません。中身は次のコマンドで見られます(表示するだけで、変更はしません)。

cat /etc/zprofile
cat /etc/zshrc

公開されているソース(2026 年 11 月時点の最新)の zshrc では、コマンドの履歴を ~/.zsh_history に保存する設定(HISTFILE・HISTSIZE=2000・SAVEHIST=1000)や、プロンプトの形(PS1="%n@%m %1~ %# "、「ユーザー名@コンピュータ名 今のフォルダ名 %」)が決められています。自分の ~/.zshrc は /etc/zshrc の後に読まれるので、同じ項目を自分のファイルに書けば上書きできます。お使いの Mac のファイルが同じ中身かどうかは、上のコマンドで確かめてください。

/etc のファイルは直接編集しないでください。全ユーザーに影響し、編集には管理者の権限(sudo)が要ります。ファイルの先頭のコメントにも「ユーザーごとの上書きは ~/.zprofile(~/.zshrc)で設定する」と書かれています。自分の設定はホームフォルダのファイルに書きます。

ログインシェルと対話シェルの違い

読み込まれるファイルが変わるのは、「ログインシェルかどうか」と「対話シェルかどうか」の 2 つの条件によります。zsh の公式マニュアル「Options」(16.2.11 Shell State)では次のように決められています。

  • ログインシェル(オプション LOGIN):-l を付けて起動したとき、または起動したプログラムの名前(argv[0])の先頭が「-」のとき。ログインしたときに最初に動くシェル、という意味です
  • 対話シェル(オプション INTERACTIVE):-i を付けて起動したとき、または標準入力が端末(キーボードから打てる画面)で、そこからコマンドを読むとき。人がプロンプトにコマンドを打つシェルのことです

2 つは別々の条件なので、組み合わせで読まれるファイルが決まります。上の読み込み順に当てはめると次のようになります(/etc のファイルは省略)。

起動のしかたログイン対話読まれるホームのファイル
ログインシェルとしてターミナルの画面で起動(zsh -l など)○○.zshenv → .zprofile → .zshrc → .zlogin
ターミナルで、さらに zsh と打って起動×○.zshenv → .zshrc
スクリプトを実行(zsh script.sh、1 行目が #!/bin/zsh のファイル)××.zshenv だけ
zsh -c 'コマンド' で 1 つだけ実行××.zshenv だけ

ここから分かる大事な点は、~/.zshrc に書いたエイリアスや関数は、シェルスクリプトの中では使えないことです。スクリプトは対話シェルではないので ~/.zshrc を読みません。逆に ~/.zshenv はスクリプトの実行のたびに読まれるので、重い処理や画面に何かを表示する処理を書くと、関係のないスクリプトの動きまで変わってしまいます。マニュアルも /etc/zshenv について「すべての zsh で実行されるので、できるだけ小さく保つことが大切」と書いています。

ターミナル.app のウインドウはどちらか

Apple のターミナルユーザガイド「Macの「ターミナル」で「一般」設定を変更する」によると、「ターミナル」>「設定」>「一般」の「開くシェル」で、新しいウインドウで使うシェルを「デフォルトのログインシェル」(ユーザーアカウントに設定されたログインシェル。標準は zsh)か「コマンド(完全パス)」から選べます。

ターミナル.app は新しいウインドウやタブを開くたびに、そのシェルをログインシェルとして起動する、と一般に説明されています。ただし、Apple の公式資料の中でこの動きをはっきり書いたページは見つけられませんでした(確認できていません)。そこで、手元で確かめる方法を紹介します。zsh のマニュアル「Conditional Expressions」によると、[[ -o オプション名 ]] はそのオプションがオンのとき真になります。開いたウインドウで次のコマンドを実行すると、ログインシェルかどうかが表示されます。

[[ -o login ]] && echo 'ログインシェルです' || echo 'ログインシェルではありません'

「ログインシェルです」と出れば、そのウインドウでは ~/.zprofile と ~/.zshrc の両方が読まれています。そのため、ターミナル.app で使う分には、PATH を ~/.zprofile と ~/.zshrc のどちらに書いても効きます。VS Code などほかのアプリの中のターミナルで「設定が効かない」ときも、まず同じコマンドでログインシェルかどうかを確かめると、どのファイルが読まれているかの見当がつきます(アプリごとの起動のしかたは、この記事では確認していません)。

/etc/zprofile と path_helper:Mac で PATH の順番が変わる理由

Mac の zsh には、ほかの OS にはないしくみがあります。Apple が公開している /etc/zprofile のソースには、次の行があります。

if [ -x /usr/libexec/path_helper ]; then
	eval `/usr/libexec/path_helper -s`
fi

ログインシェルが起動するたびに、/usr/libexec/path_helper というプログラムが PATH を組み立て直している、という意味です。Apple の path_helper の man ページ(説明書)によると、path_helper は次のように動きます。

  • まず /etc/paths の内容を PATH の基本の値にする
  • 次に /etc/paths.d フォルダにあるファイルの内容を PATH に追加する(1 行に 1 つのフォルダ)
  • -s を付けると、bash や zsh で使える形(PATH="..."; export PATH;)で出力する。これを eval で実行して PATH に反映する
  • 直接実行するものではなく、シェルの設定ファイルから使うためのもの

さらに path_helper のソースコードを読むと、/etc/paths と /etc/paths.d のフォルダを並べたあとで、それまでの PATH にあったフォルダを、まだ入っていないものだけ後ろに付け足す作りになっています。つまり、~/.zshenv で PATH の先頭に自分のフォルダを入れても、その後に読まれる /etc/zprofile で /usr/bin などシステムのフォルダより後ろに回されます。

PATH は前から順に探されるので、後ろに回ると「新しく入れた版ではなく、Mac に最初から入っている同じ名前のコマンドが動く」ことになります。これが「PATH は ~/.zshenv に書かず、/etc/zprofile より後に読まれる ~/.zprofile か ~/.zshrc に書く」理由です。

基本の PATH の中身は次のコマンドで見られます。

cat /etc/paths
ls /etc/paths.d

/etc/paths や /etc/paths.d にファイルを足すと全ユーザーの PATH が変わりますが、sudo(管理者の権限)が必要で、書き間違えると全員のコマンドが見つからなくなるおそれがあります。自分だけが使う PATH は、ホームフォルダの設定ファイルに書くのが安全です。

設定ファイルを開く・編集する前に

設定ファイルは名前が「.」で始まる隠しファイルなので、ls では見えず、ls -a で表示されます。まだ作られていないこともあります。編集する前に、念のためコピーを取っておきます(ファイルがない場合は「No such file or directory」と出るだけなので、そのまま次へ進んでかまいません)。

cp ~/.zshrc ~/.zshrc.bak

Apple のターミナルユーザガイド「Macの「ターミナル」でコマンドラインテキストエディタを使用する」では、入門用のエディタとして nano が紹介されています。次のコマンドで ~/.zshrc を開けます(ファイルがなければ、保存したときに作られます)。

nano ~/.zshrc

nano では画面の下に操作の一覧が出ます(「^」は Control キーのことです)。保存は Control+O を押してから return キー、終了は Control+X です。

echo '...' >> ~/.zshrc のように 1 行ずつ書き足す方法もありますが、>> を > と打ち間違えるとファイルの中身が消えます。複数の行を書くときはエディタで開くほうが安全です。

PATH を追加する

PATH の意味と Windows・Linux での設定は「環境変数PATHとは?Windows・Linuxの確認・設定と「認識されません」の直し方」で説明しています。ここでは zsh ならではの書き方を紹介します。

zsh では path(小文字)が配列になっている

zsh のマニュアル「Parameters Used By The Shell」によると、zsh には PATH(大文字)と path(小文字)の 2 つがあり、つながっています。

  • PATH:フォルダを :(コロン)でつないだ 1 つの文字列。ほかのプログラムに渡す(環境変数として使う)ための形
  • path:同じフォルダを 1 つずつ要素にした配列(値を並べたもの)。シェルの中で扱いやすい形

片方を変えると、もう片方も自動で変わります。今の PATH を 1 行に 1 つずつ表示するには、print -l(引数を改行で区切って表示する組み込みコマンド)で path を表示すると見やすくなります。

print -l $path

おすすめの書き方:typeset -U と path

ホームフォルダの bin フォルダ(自分で作ったスクリプトを置く場所の例)を PATH の先頭に追加するには、~/.zprofile(または ~/.zshrc)に次のように書きます。

# PATH に同じフォルダが二重に入らないようにする
typeset -U path PATH

# ~/bin を先頭に追加する
path=("$HOME/bin" $path)

1 行目の typeset -U は、zsh のマニュアル「Shell Builtin Commands」によると、配列の中で同じ値が重なったら最初の 1 つだけを残す指定です。マニュアルでは、PATH と path のように値を共有している変数には両方に付けるよう勧めていて、例として typeset -U PATH path が挙がっています。これがあると、設定ファイルを何度読み込み直しても PATH に同じフォルダが増えていきません。

2 行目は、path 配列を「$HOME/bin、その後ろに今までの path の全部」に置き換えています。$path を書き忘れると元の PATH が消えて、ls などの基本のコマンドも見つからなくなるので注意してください。

先頭ではなく最後に追加したいときは、マニュアル「Parameters」にある、配列に値を足す書き方 += を使います。

path+=("$HOME/.local/bin")

先頭と最後の違いは、同じ名前のコマンドが複数のフォルダにあるときにどちらが使われるかです。先頭に追加したフォルダのコマンドが優先されます。Mac に最初から入っているコマンドを別の版で置き換えたいときは先頭、置き換えずに足すだけなら最後、と考えます。

bash と同じ export PATH="$HOME/bin:$PATH" という書き方も、zsh でそのまま使えます(Apple のサポート記事でも、環境変数は export で設定できると説明されています)。どちらで書いても同じ PATH になるので、読みやすいほうを選んでください。

どのコマンドが使われているかを確かめる

PATH を変えたら、目的のコマンドが期待どおりの場所から動くかを確かめます。zsh のマニュアルによると、which に -a を付けると、PATH の中で見つかったすべての場所を表示します(付けないと最初の 1 つだけ)。いちばん上に出たものが実際に使われます。

which -a python3

zsh は、PATH のフォルダにあるコマンドの一覧を覚えておく(ハッシュ表)しくみを持っています。PATH のフォルダに新しいコマンドを置いたのに見つからないときは、rehash(マニュアルでは hash -r と同じ)で一覧を作り直します。

rehash

Homebrew の PATH

Homebrew の公式ドキュメント「Installation」によると、インストールが終わるとシェルの設定ファイルを更新する手順が表示され、それに従わないと Homebrew は動きません。設定ファイルには eval "$(<Homebrew のインストール先>/bin/brew shellenv)" という行を書き足します(ドキュメントでは、どのファイルに書くかはシェルによるとして、例に ~/.zshrc などが挙がっています)。インストールの最後に表示される指示のとおりに実行するのが確実です。詳しくは「Homebrewの使い方|インストール・brew install・upgrade・cask・Appleシリコンでの場所」を参照してください。

PATH に入れてはいけないもの

Apple の開発者向け資料「Command Line Primer」によると、Mac では安全のために、今いるフォルダ(.)は PATH に含まれておらず、含めるべきでもないとされています。. を PATH に入れると、ダウンロードしたフォルダなどに ls と同じ名前の悪いプログラムが置かれていた場合に、それを実行してしまうおそれがあります。同じ理由で、だれでも書き込めるフォルダや、中身をよく知らないフォルダも PATH に入れないでください。

エイリアスを設定する

エイリアスは、よく使うコマンドに短い別名を付けるしくみです。人がコマンドを打つときにだけ使うものなので、~/.zshrc に書きます。zsh のマニュアル「Shell Builtin Commands」の alias の書式は alias 名前=値 です。

# ls -la を ll で実行できるようにする
alias ll='ls -la'

# よく行くフォルダに移動する
alias proj='cd ~/projects'

= の前後にスペースを入れないこと、スペースを含む値は '(シングルクォート)で囲むことに気をつけます。設定されているエイリアスの一覧は、引数を付けずに alias と打つと表示されます。

alias

今のシェルからエイリアスを消すには unalias を使います(~/.zshrc に書いた行も消さないと、次のウインドウでまた設定されます)。

unalias ll

エイリアスについて、マニュアル「Aliasing」から知っておくとよいことを挙げます。

  • エイリアスが置き換わるのは、原則としてコマンドの位置(行の最初の単語など)だけ
  • エイリアスを使わずに元のコマンドを実行したいときは、\ll のように単語の一部を引用(\ を付けるなど)すればよい
  • alias -g で作る「グローバルエイリアス」は、行のどこにあっても置き換わる。思わぬところで置き換わって混乱しやすいので、慣れるまでは使わないほうが安全

alias rm='rm -i'(削除の前に確認する)のような「安全のためのエイリアス」もよく紹介されます。ただし、前の章で見たとおり シェルスクリプトや zsh -c では ~/.zshrc が読まれないので、このエイリアスは効きません。エイリアスがあるつもりで rm を使うと、ほかの場面で確認なしに消してしまいます。rm は「ゴミ箱に入らず、すぐ消える」ことを前提に、慎重に使ってください。

引数を使うなら関数にする

エイリアスは文字を置き換えるだけなので、「受け取った値を途中で使う」ことはできません。そういうときは関数にします。zsh のマニュアル「Functions」によると、関数は function という語か、名前() という書き方で定義し、受け取った値は $1、$2… で使えます。関数もエイリアスと同じく ~/.zshrc に書きます。

次は、フォルダを作って、そのままそこへ移動する関数の例です。

# フォルダを作って移動する(例:mkcd work/test)
mkcd() {
  mkdir -p -- "$1" && cd -- "$1"
}
  • "$1" を " で囲んでいるのは、スペースを含むフォルダ名でも 1 つの名前として扱うため
  • -- は「ここから後ろはオプションではない」という印で、- で始まる名前を渡したときの誤動作を防ぐ
  • && は「前のコマンドが成功したときだけ次を実行する」という意味

マニュアルには「エイリアスは関数を読み込んだ時点で置き換えられる」とも書かれています。関数の中でエイリアスを使うなら、エイリアスの定義を関数より前に書いておきます。定義済みの関数の中身は functions 関数名、関数を消すのは unfunction 関数名 です。

functions mkcd

入力したものがエイリアス・関数・組み込みコマンド・外部のコマンドのどれとして動くかは、whence -w で調べられます(マニュアルによると、alias・builtin・command・function などの種類を表示します)。

whence -w ll

書いた設定を反映させる

まず書き間違いがないか確かめる

zsh のマニュアル(Options の EXEC)によると、-n を付けて起動すると、コマンドを実行せずに読み込んで文法の誤りだけを調べます。反映させる前に、次のコマンドで確かめると安心です。何も表示されなければ、文法の誤りは見つからなかったということです。

zsh -n ~/.zshrc

ただし、調べられるのは文法だけです。フォルダ名の打ち間違いのような中身の誤りは見つけられません。

source で今のシェルに読み込む

設定ファイルは起動のときに読まれるので、書き換えても今開いているウインドウには反映されません。いちばん確実なのは、ターミナルのウインドウを開き直すことです。今のウインドウにすぐ反映したいときは、source で読み込み直します。

source ~/.zshrc

マニュアル「Shell Builtin Commands」によると、.(ドット)コマンドは「ファイルのコマンドを今のシェルの中で実行する」もので、source はそれとほぼ同じです(違いは、ファイルを探すときに今いるフォルダを必ず最初に探すこと)。~/.zprofile を書き換えたときは source ~/.zprofile です。

source は「上から書いてあるとおりにもう一度実行する」だけなので、次の点に注意します。

  • ファイルから消した設定は、今のシェルからは消えない(エイリアスの行を消しても、unalias するか開き直すまで残る)
  • PATH を追加する行は、読み込むたびにもう一度追加される。typeset -U path PATH を書いておけば重複は残らない

まっさらな状態から読み込み直したいときは、ウインドウを開き直すか、exec zsh -l を使います。マニュアルによると、exec は今のシェルを指定したコマンドに置き換えるもので、ここでは今のシェルが新しいログインシェルの zsh に入れ替わり、設定ファイルが最初から読まれます。

exec zsh -l

設定を壊してコマンドが使えなくなったら

PATH の書き間違いで ls なども「command not found」になったときは、フルパスで書けばコマンドを実行できます。たとえば、取っておいたコピーで元に戻すには次のようにします(/bin/cp はコピーのコマンドの本体の場所です)。

/bin/cp ~/.zshrc.bak ~/.zshrc

設定ファイルの中の処理が原因でシェルがうまく動かないときは、前に説明した -f を付けて、設定ファイルを読まない zsh を起動してから直す方法もあります。

/bin/zsh -f

直し終わったら exit でこのシェルを終え、ウインドウを開き直して確かめます。

bash から zsh に移行する

Apple のサポート記事「zshをMacのデフォルトシェルとして使う」によると、zsh は macOS 10.15 以降で新しく作られるすべてのユーザーアカウントの標準のシェルで、macOS 10.14 以前は bash が標準でした。古い Mac から引き継いだアカウントなどで、まだ bash を使っている場合の移り方をまとめます。

今のログインシェルを確かめる

環境変数 SHELL には、通常、ユーザーアカウントに設定されたログインシェルのパスが入っています。/bin/zsh と出れば zsh です。

echo $SHELL

ログインシェルを zsh に変える

Apple のサポート記事にある方法は 2 つです。1 つめはターミナルで chsh -s を使う方法で、-s の後ろには /etc/shells に書かれているシェルのパス(/bin/zsh など)を指定します。

chsh -s /bin/zsh

2 つめは「システム設定」から変える方法です(macOS 13 以降)。

  1. 画面左上のアップルメニューをクリックし、「システム設定」を選ぶ
  2. サイドバーの「ユーザとグループ」をクリックする
  3. 右側のユーザーの一覧で、自分のユーザー名か画像を、control キーを押しながらクリックする
  4. 表示されたメニューから「詳細オプション」を選ぶ
  5. 画面の案内に従って、ユーザー名とパスワードを入力する
  6. 「ログインシェル」のメニューから /bin/zsh を選ぶ
  7. 「OK」をクリックして保存する

「詳細オプション」には、ユーザーのアカウント名やホームフォルダの場所など、変えるとログインできなくなるおそれのある項目も並んでいます。「ログインシェル」以外の項目は変えないでください。変えたあとは、ターミナルのウインドウを開き直すと新しいシェルで起動します。

bash を使い続ける場合、bash を起動すると「標準のシェルは zsh になった」という案内が表示されます。Apple のサポート記事によると、この表示は ~/.bash_profile か ~/.profile に export BASH_SILENCE_DEPRECATION_WARNING=1 を書くと消せます。

bash の設定を zsh のファイルに移す

zsh は ~/.bash_profile や ~/.bashrc を読みません。Apple のサポート記事にあるとおり、内容を対応する zsh のファイルに移します。

bash のファイル移す先(zsh)
~/.bash_profile~/.zprofile
~/.bashrc~/.zshrc
~/.profile(POSIX 互換の設定)そのまま使うなら、~/.zprofile から読み込む(下を参照)

~/.profile を使っている場合、Apple のサポート記事では、次の行を ~/.zprofile に書いて、zsh から自動で読み込む方法が紹介されています。emulate sh -c は、そのファイルを sh(POSIX のシェル)の決まりで読み込むという意味です。

[[ -e ~/.profile ]] && emulate sh -c 'source ~/.profile'

export MY_SETTING=1 のような環境変数の設定や、alias の行は、多くはそのまま移せます。一方、次のような bash との違いがあるので、移したあとは動きを確かめてください。

  • プロンプトの書き方が違う:bash の PS1 の記号(\h・\W など)は zsh では使えない。Apple のサポート記事には、bash の export PS1="\[\e[92;40m\]\h\[\e[m\]:\[\e[93m\]\W\[\e[m\] \\$ " を zsh では export PS1="%10F%m%f:%11F%1~%f \$ " と書く例が載っている
  • 配列の番号が 1 から始まる:zsh のマニュアル(Options の KSH_ARRAYS)によると、この指定がオフ(zsh の標準)のとき、配列の要素は 1 番から数える。bash は 0 番から
  • 引用符なしの変数がスペースで分けられない:zsh の標準では SH_WORD_SPLIT がオフなので、$var を引用符なしで書いても、値の中のスペースで複数に分かれない(bash は分かれる)
  • bash 専用の組み込みコマンドは使えない:たとえば shopt は zsh のマニュアルの組み込みコマンドの一覧にない。zsh では setopt などでオプションを設定する

bash 用に書いたシェルスクリプトは、1 行目が #!/bin/bash なら、ログインシェルを zsh に変えたあとも bash で動きます。設定ファイルを移すことと、スクリプトを書き直すことは別の話です。シェルスクリプトの書き方は「シェルスクリプト入門|bashの変数・if・for・終了ステータスを実例で解説」で説明しています。

セキュリティの注意

  • 意味の分からない行を貼り付けない:設定ファイルの中身は、ターミナルを開くたびに自分の権限で実行されます。ネットで見つけた設定を貼るときは、1 行ずつ意味を確かめてから書いてください。特に、ネットからスクリプトを取ってきて実行する行(curl ... | sh のような形)や、知らないファイルを source する行には注意が必要です
  • パスワードや API キーを書かない:export API_KEY=... のように秘密の値を設定ファイルに書くと、ファイルのバックアップや、設定ファイルを共有したとき(GitHub の dotfiles など)に漏れるおそれがあります。扱い方は「.envと環境変数で秘密情報を守る|APIキーをGitに上げない方法と漏れたときの対処」を参照してください
  • sudo で /etc のファイルを書き換えない:自分の設定はホームフォルダのファイルで足ります
  • 今いるフォルダ(.)を PATH に入れない(前の「PATH に入れてはいけないもの」を参照)

よくある質問

~/.zshrc が見つかりません

最初からあるとは限りません。名前が「.」で始まる隠しファイルなので、ls -a ~ で確かめます。なければ、nano ~/.zshrc で開いて保存すると作られます。

PATH は .zprofile と .zshrc のどちらに書けばよいですか?

ターミナル.app のようにログインシェルとして起動する場合は、どちらでも効きます。この記事では、Apple の説明(環境変数などログイン時の設定は .zprofile)に合わせて ~/.zprofile をおすすめしますが、すでに ~/.zshrc に書いていて問題なく動いているなら、無理に移す必要はありません。避けたいのは、同じ設定を両方に書くことと、~/.zshenv に書くこと(path_helper で順番が変わる)です。

.zshrc に書いたエイリアスがスクリプトの中で使えません

スクリプトは対話シェルではないので、~/.zshrc を読みません。スクリプトの中では、エイリアスを使わずに元のコマンドをそのまま書いてください。

設定ファイルを別のフォルダにまとめられますか?

zsh のマニュアルによると、ZDOTDIR という変数にフォルダを設定すると、.zshrc などの設定ファイルを、ホームフォルダの代わりにそのフォルダから読むようになります(「Parameters Used By The Shell」「Files」)。ただし、どのファイルを読むより前に設定しておく必要があるなど気をつける点があり、初めのうちはホームフォルダに置いたままで十分です。

まとめ

  • 読み込み順は .zshenv(毎回)→ .zprofile(ログイン)→ .zshrc(対話)→ .zlogin(ログイン)。/etc の同じ名前のファイルがそれぞれの直前に読まれる
  • ログインシェルかどうかと、対話シェルかどうかは別の条件。スクリプトは .zshenv しか読まない。[[ -o login ]] で確かめられる
  • Mac の /etc/zprofile は path_helper で PATH を組み立て直し、それまでの PATH を後ろに回す。だから PATH は .zshenv ではなく .zprofile(または .zshrc)に書く
  • PATH は typeset -U path PATH と path=("$HOME/bin" $path) で重複なく追加できる。which -a で確かめる
  • エイリアスと関数は .zshrc に書く。引数を使うなら関数にする
  • 書いたら zsh -n で文法を確かめ、source かウインドウの開き直し、または exec zsh -l で反映する
  • bash からは chsh -s /bin/zsh か「ユーザとグループ」で移り、.bash_profile → .zprofile、.bashrc → .zshrc に設定を移す

関連する記事

ABOUT ME
hr
hr
エンジニアとして働いている hr です。仕事や資格勉強で「こんなツールがあれば」と感じたものを、無料Webツールと解説記事にして発信しています。
記事URLをコピーしました