はじめに

ターミナル環境を見やすく、使いやすくするために、

Zsh
Oh My Zsh
Powerlevel10k
Nerd Font

を導入します。

この記事では macOS と Ubuntu の両方について、ZshのインストールからPowerlevel10kの設定までまとめます。

最終的には、例えば次のような情報をプロンプトに表示できるようになります。

OSやホストを表すアイコン
ホームディレクトリや現在のディレクトリ
Gitブランチ
Gitの変更状態
Python仮想環境
コマンドの終了ステータス

特にPowerlevel10kでは特殊なアイコンを多数使用するため、Nerd Fontの設定が重要です。

1. 全体の構成

今回構築する環境は次のようになります。

Terminal
  └── Zsh
       └── Oh My Zsh
            └── Powerlevel10k

さらに、アイコンを正しく表示するために、

MesloLGS NF

というNerd Fontをターミナルに設定します。

大まかな流れは、

1. Zshをインストール
2. Zshをデフォルトシェルにする
3. Oh My Zshをインストール
4. Powerlevel10kをインストール
5. Nerd Fontをインストール
6. ターミナルでNerd Fontを指定
7. p10k configure を実行

です。

2. macOSの場合

2.1 Zshの確認

現在のmacOSではZshが標準でインストールされているため、まず確認します。

zsh --version

例えば、

zsh 5.x.x (...)

のように表示されればOKです。

使用中のシェルも確認できます。

echo $SHELL

/bin/zsh

となっていれば、すでにZshがデフォルトシェルです。

その場合、Zshを追加でインストールする必要はありません。

Homebrew版Zshを使用したい場合

Homebrew版を使いたい場合は、

brew install zsh

でもインストールできます。

ただし、特に理由がなければmacOS標準のZshで十分です。

3. Ubuntuの場合

UbuntuではZshをインストールします。

sudo apt update
sudo apt install -y zsh git curl

インストールを確認します。

zsh --version

Zshの場所も確認します。

which zsh

通常は、

/usr/bin/zsh

となります。

3.1 Zshをデフォルトシェルにする

Ubuntuでは、

chsh -s "$(which zsh)"

を実行します。

確認します。

grep "$USER" /etc/passwd

末尾が、

/usr/bin/zsh

になっていれば設定されています。

一度ログアウトして、再度ログインします。

その後、

echo $SHELL

を実行して、

/usr/bin/zsh

となっていればOKです。

4. Oh My Zshのインストール

macOS / Ubuntuともに、ここからはほぼ同じです。

Oh My Zshをインストールします。

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

インストールが完了すると、

~/.oh-my-zsh

が作成されます。

また、

~/.zshrc

も作成されます。

確認してみます。

ls -la ~ | grep zsh

5. Powerlevel10kのインストール

Powerlevel10kをOh My Zshのカスタムテーマディレクトリにcloneします。

git clone --depth=1 \
  https://github.com/romkatv/powerlevel10k.git \
  "${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k"

次に、

nano ~/.zshrc

などで .zshrc を開きます。

次の行を探します。

ZSH_THEME="robbyrussell"

これを、

ZSH_THEME="powerlevel10k/powerlevel10k"

に変更します。

保存したらZshを起動し直します。

exec zsh

初回起動時にはPowerlevel10kの設定ウィザードが起動します。

起動しない場合は、

p10k configure

を実行します。

6. Nerd Fontをインストールする

Powerlevel10kでは、

フォルダ
Git
Home
OS
各種ステータス

などをアイコンで表示します。

通常のフォントではこれらの文字を持っていないことがあるため、Nerd Fontを使用します。

Powerlevel10kで推奨されているのが、

MesloLGS NF

です。

必要なのは基本的に次の4フォントです。

MesloLGS NF Regular
MesloLGS NF Bold
MesloLGS NF Italic
MesloLGS NF Bold Italic

7. macOSにMesloLGS NFをインストール

例えば次のようにダウンロードします。

mkdir -p ~/Downloads/MesloLGS-NF
cd ~/Downloads/MesloLGS-NF

curl -fLo "MesloLGS NF Regular.ttf" \
"https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Regular.ttf"

curl -fLo "MesloLGS NF Bold.ttf" \
"https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Bold.ttf"

curl -fLo "MesloLGS NF Italic.ttf" \
"https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Italic.ttf"

curl -fLo "MesloLGS NF Bold Italic.ttf" \
"https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Bold%20Italic.ttf"

Finderから各 .ttf ファイルを開いて、

インストール

を選択します。

8. UbuntuにMesloLGS NFをインストール

Ubuntuではユーザー用フォントディレクトリ、

~/.local/share/fonts

に入れるのがおすすめです。

mkdir -p ~/.local/share/fonts
cd ~/.local/share/fonts

フォントをダウンロードします。

wget \
"https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Regular.ttf"

wget \
"https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Bold.ttf"

wget \
"https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Italic.ttf"

wget \
"https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Bold%20Italic.ttf"

フォントキャッシュを更新します。

fc-cache -fv

インストールされたか確認します。

fc-list | grep "MesloLGS NF"

表示されればOKです。

`~/.fonts` でもよい？

以前は、

~/.fonts

もよく使われていました。

現在は、

~/.local/share/fonts

を使用するほうがよいでしょう。

9. ターミナル側のフォントを変更する

フォントをOSへインストールしただけでは、Powerlevel10kのアイコンが正しく表示されないことがあります。

実際に使用しているターミナルのフォントを MesloLGS NF に変更します。

ここがかなり重要です。

macOS Terminal

Terminalの設定から、

Terminal
  → Settings
  → Profiles
  → Text
  → Font

を開き、

MesloLGS NF

を指定します。

iTerm2

iTerm2の場合は、

Settings
  → Profiles
  → Text
  → Font

から、

MesloLGS NF

を指定します。

Ghostty

Ghosttyでは設定ファイルに、

font-family = "MesloLGS NF"

を指定します。

macOS/Linuxともに、設定を反映したあとGhosttyを再起動します。

GNOME Terminal

Ubuntu標準のGNOME Terminalの場合、

Preferences
 → Profile
 → Text
 → Custom font

を有効にして、

MesloLGS NF

を選択します。

VS Code

VS CodeのIntegrated TerminalでもPowerlevel10kを使用する場合は、

"terminal.integrated.fontFamily": "MesloLGS NF"

を設定します。

10. Powerlevel10kの初期設定

フォントを設定した状態で、

p10k configure

を実行します。

Powerlevel10kの設定ウィザードが開始されます。

最初に、

Does this look like a diamond?

など、特殊文字が正常に見えているか確認されます。

正常に表示されていれば、

Yes

を選択します。

その後、

Prompt Style
Character Set
Show Current Time?
Prompt Separators
Prompt Heads
Prompt Tails
Prompt Height
Prompt Connection
Prompt Frame
Prompt Spacing
Icons
Prompt Flow
Transient Prompt
Instant Prompt

などを対話形式で設定できます。

特にこだわりがなければ、プレビューを見ながら好きなものを選んでいけば問題ありません。

11. Powerlevel10kの設定ファイル

設定ウィザードを完了すると、

~/.p10k.zsh

が作成されます。

.zshrc の末尾付近には通常、

[[ ! -f ~/.p10k.zsh ]] || source ~/.p10k.zsh

が追加されます。

したがって構成としては、

~/.zshrc
    ↓
~/.p10k.zsh

となっています。

Powerlevel10kの細かい表示を変更したい場合は、

nano ~/.p10k.zsh

などで編集できます。

12. Powerlevel10kを再設定する

デザインを変更したくなった場合は簡単です。

p10k configure

をもう一度実行します。

設定ウィザードが最初から起動します。

例えば、

アイコンを増やしたい
1行表示から2行表示に変更したい
Git情報の見え方を変えたい
Unicode表示がおかしいので再設定したい

といった場合に便利です。

13. AppleマークやHomeアイコンが表示されない場合

Powerlevel10kは動いているのに、



やHome、Gitなどのアイコンが表示されず、

□

や文字化けになってしまうことがあります。

この場合、Powerlevel10kそのものではなく、フォント設定が原因であることが多いです。

まず、

p10k configure

を実行します。

最初の特殊文字確認で正しく表示されなければ、ターミナルのフォントを確認します。

使用しているフォントが、

MesloLGS NF

になっていることを確認します。

単に、

Meslo

や、

Migu 1M

などを指定しただけでは、Powerlevel10kで使用するNerd Fontのアイコンがすべて表示できるとは限りません。

Powerlevel10kのアイコン表示を確実にしたい場合は、

MesloLGS NF

を使用するのが簡単です。

14. Oh My Zshのプラグイン

Oh My Zshでは .zshrc の、

plugins=(git)

という部分でプラグインを設定できます。

例えば、

plugins=(
  git
  sudo
)

とできます。

変更後は、

exec zsh

でZshを再起動します。

15. autosuggestionsとsyntax highlightingも追加する

さらに使いやすくしたい場合には、

zsh-autosuggestions
zsh-syntax-highlighting

も便利です。

zsh-autosuggestions

git clone https://github.com/zsh-users/zsh-autosuggestions \
"${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions"

zsh-syntax-highlighting

git clone https://github.com/zsh-users/zsh-syntax-highlighting.git \
"${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting"

.zshrc を、

plugins=(
  git
  sudo
  zsh-autosuggestions
  zsh-syntax-highlighting
)

のように変更します。

その後、

exec zsh

します。

16. `.zshrc` の例

最終的な .zshrc の主要部分は、例えば次のようになります。

# Path to your Oh My Zsh installation.
export ZSH="$HOME/.oh-my-zsh"

# Powerlevel10k
ZSH_THEME="powerlevel10k/powerlevel10k"

# Oh My Zsh plugins
plugins=(
  git
  sudo
  zsh-autosuggestions
  zsh-syntax-highlighting
)

source $ZSH/oh-my-zsh.sh

# Powerlevel10k configuration
[[ ! -f ~/.p10k.zsh ]] || source ~/.p10k.zsh

実際にはPowerlevel10kのInstant Prompt関連の記述なども追加されるため、p10k configure が生成した内容は基本的にそのまま残しておくことをおすすめします。

17. Powerlevel10kのアップデート

Oh My Zshのカスタムテーマとしてインストールした場合、

git -C \
"${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k" \
pull

でPowerlevel10kを更新できます。

更新後は、

exec zsh

でZshを再起動します。

18. Oh My Zshのアップデート

Oh My Zshは、

omz update

で更新できます。

19. UbuntuでZshにならない場合

設定したのにBashのままの場合は、

echo $SHELL

を確認します。

まだ、

/bin/bash

となっていたら、

chsh -s "$(which zsh)"

を実行し直します。

その後、ターミナルを閉じるだけではなく、一度ログアウトしてログインし直します。

20. 設定をバックアップする

別のPCでも同じPowerlevel10k設定を使いたい場合は、

~/.zshrc
~/.p10k.zsh

を保存しておくと便利です。

例えばGitHubのdotfilesリポジトリなどで管理しておけば、

Mac
Ubuntu
リモートワークステーション

などでほぼ同じZsh環境を構築できます。

ただし、

~/.oh-my-zsh

そのものをバックアップするよりも、

.zshrc
.p10k.zsh

macOS / Ubuntu で Zsh + Oh My Zsh + Powerlevel10k 環境を構築する

はじめに

ターミナル環境を見やすく、使いやすくするために、

Zsh
Oh My Zsh
Powerlevel10k
Nerd Font

を導入します。

この記事では macOS と Ubuntu の両方について、ZshのインストールからPowerlevel10kの設定までまとめます。

最終的には、例えば次のような情報をプロンプトに表示できるようになります。

OSやホストを表すアイコン
ホームディレクトリや現在のディレクトリ
Gitブランチ
Gitの変更状態
Python仮想環境
コマンドの終了ステータス

特にPowerlevel10kでは特殊なアイコンを多数使用するため、Nerd Fontの設定が重要です。

1. 全体の構成

今回構築する環境は次のようになります。

Terminal
  └── Zsh
       └── Oh My Zsh
            └── Powerlevel10k

さらに、アイコンを正しく表示するために、

MesloLGS NF

というNerd Fontをターミナルに設定します。

大まかな流れは、

1. Zshをインストール
2. Zshをデフォルトシェルにする
3. Oh My Zshをインストール
4. Powerlevel10kをインストール
5. Nerd Fontをインストール
6. ターミナルでNerd Fontを指定
7. p10k configure を実行

です。

2. macOSの場合

2.1 Zshの確認

現在のmacOSではZshが標準でインストールされているため、まず確認します。

zsh --version

例えば、

zsh 5.x.x (...)

のように表示されればOKです。

使用中のシェルも確認できます。

echo $SHELL

/bin/zsh

となっていれば、すでにZshがデフォルトシェルです。

その場合、Zshを追加でインストールする必要はありません。

Homebrew版Zshを使用したい場合

Homebrew版を使いたい場合は、

brew install zsh

でもインストールできます。

ただし、特に理由がなければmacOS標準のZshで十分です。

3. Ubuntuの場合

UbuntuではZshをインストールします。

sudo apt update
sudo apt install -y zsh git curl

インストールを確認します。

zsh --version

Zshの場所も確認します。

which zsh

通常は、

/usr/bin/zsh

となります。

3.1 Zshをデフォルトシェルにする

Ubuntuでは、

chsh -s "$(which zsh)"

を実行します。

確認します。

grep "$USER" /etc/passwd

末尾が、

/usr/bin/zsh

になっていれば設定されています。

一度ログアウトして、再度ログインします。

その後、

echo $SHELL

を実行して、

/usr/bin/zsh

となっていればOKです。

4. Oh My Zshのインストール

macOS / Ubuntuともに、ここからはほぼ同じです。

Oh My Zshをインストールします。

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

インストールが完了すると、

~/.oh-my-zsh

が作成されます。

また、

~/.zshrc

も作成されます。

確認してみます。

ls -la ~ | grep zsh

5. Powerlevel10kのインストール

Powerlevel10kをOh My Zshのカスタムテーマディレクトリにcloneします。

git clone --depth=1 \
  https://github.com/romkatv/powerlevel10k.git \
  "${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k"

次に、

nano ~/.zshrc

などで .zshrc を開きます。

次の行を探します。

ZSH_THEME="robbyrussell"

これを、

ZSH_THEME="powerlevel10k/powerlevel10k"

に変更します。

保存したらZshを起動し直します。

exec zsh

初回起動時にはPowerlevel10kの設定ウィザードが起動します。

起動しない場合は、

p10k configure

を実行します。

6. Nerd Fontをインストールする

Powerlevel10kでは、

フォルダ
Git
Home
OS
各種ステータス

などをアイコンで表示します。

通常のフォントではこれらの文字を持っていないことがあるため、Nerd Fontを使用します。

Powerlevel10kで推奨されているのが、

MesloLGS NF

です。

必要なのは基本的に次の4フォントです。

MesloLGS NF Regular
MesloLGS NF Bold
MesloLGS NF Italic
MesloLGS NF Bold Italic

7. macOSにMesloLGS NFをインストール

例えば次のようにダウンロードします。

mkdir -p ~/Downloads/MesloLGS-NF
cd ~/Downloads/MesloLGS-NF

curl -fLo "MesloLGS NF Regular.ttf" \
"https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Regular.ttf"

curl -fLo "MesloLGS NF Bold.ttf" \
"https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Bold.ttf"

curl -fLo "MesloLGS NF Italic.ttf" \
"https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Italic.ttf"

curl -fLo "MesloLGS NF Bold Italic.ttf" \
"https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Bold%20Italic.ttf"

Finderから各 .ttf ファイルを開いて、

インストール

を選択します。

8. UbuntuにMesloLGS NFをインストール

Ubuntuではユーザー用フォントディレクトリ、

~/.local/share/fonts

に入れるのがおすすめです。

mkdir -p ~/.local/share/fonts
cd ~/.local/share/fonts

フォントをダウンロードします。

wget \
"https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Regular.ttf"

wget \
"https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Bold.ttf"

wget \
"https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Italic.ttf"

wget \
"https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Bold%20Italic.ttf"

フォントキャッシュを更新します。

fc-cache -fv

インストールされたか確認します。

fc-list | grep "MesloLGS NF"

表示されればOKです。

`~/.fonts` でもよい？

以前は、

~/.fonts

もよく使われていました。

現在は、

~/.local/share/fonts

を使用するほうがよいでしょう。

9. ターミナル側のフォントを変更する

フォントをOSへインストールしただけでは、Powerlevel10kのアイコンが正しく表示されないことがあります。

実際に使用しているターミナルのフォントを MesloLGS NF に変更します。

ここがかなり重要です。

macOS Terminal

Terminalの設定から、

Terminal
  → Settings
  → Profiles
  → Text
  → Font

を開き、

MesloLGS NF

を指定します。

iTerm2

iTerm2の場合は、

Settings
  → Profiles
  → Text
  → Font

から、

MesloLGS NF

を指定します。

Ghostty

Ghosttyでは設定ファイルに、

font-family = "MesloLGS NF"

を指定します。

macOS/Linuxともに、設定を反映したあとGhosttyを再起動します。

GNOME Terminal

Ubuntu標準のGNOME Terminalの場合、

Preferences
 → Profile
 → Text
 → Custom font

を有効にして、

MesloLGS NF

を選択します。

VS Code

VS CodeのIntegrated TerminalでもPowerlevel10kを使用する場合は、

"terminal.integrated.fontFamily": "MesloLGS NF"

を設定します。

10. Powerlevel10kの初期設定

フォントを設定した状態で、

p10k configure

を実行します。

Powerlevel10kの設定ウィザードが開始されます。

最初に、

Does this look like a diamond?

など、特殊文字が正常に見えているか確認されます。

正常に表示されていれば、

Yes

を選択します。

その後、

Prompt Style
Character Set
Show Current Time?
Prompt Separators
Prompt Heads
Prompt Tails
Prompt Height
Prompt Connection
Prompt Frame
Prompt Spacing
Icons
Prompt Flow
Transient Prompt
Instant Prompt

などを対話形式で設定できます。

特にこだわりがなければ、プレビューを見ながら好きなものを選んでいけば問題ありません。

11. Powerlevel10kの設定ファイル

設定ウィザードを完了すると、

~/.p10k.zsh

が作成されます。

.zshrc の末尾付近には通常、

[[ ! -f ~/.p10k.zsh ]] || source ~/.p10k.zsh

が追加されます。

したがって構成としては、

~/.zshrc
    ↓
~/.p10k.zsh

となっています。

Powerlevel10kの細かい表示を変更したい場合は、

nano ~/.p10k.zsh

などで編集できます。

12. Powerlevel10kを再設定する

デザインを変更したくなった場合は簡単です。

p10k configure

をもう一度実行します。

設定ウィザードが最初から起動します。

例えば、

アイコンを増やしたい
1行表示から2行表示に変更したい
Git情報の見え方を変えたい
Unicode表示がおかしいので再設定したい

といった場合に便利です。

13. AppleマークやHomeアイコンが表示されない場合

Powerlevel10kは動いているのに、



やHome、Gitなどのアイコンが表示されず、

□

や文字化けになってしまうことがあります。

この場合、Powerlevel10kそのものではなく、フォント設定が原因であることが多いです。

まず、

p10k configure

を実行します。

最初の特殊文字確認で正しく表示されなければ、ターミナルのフォントを確認します。

使用しているフォントが、

MesloLGS NF

になっていることを確認します。

単に、

Meslo

や、

Migu 1M

などを指定しただけでは、Powerlevel10kで使用するNerd Fontのアイコンがすべて表示できるとは限りません。

Powerlevel10kのアイコン表示を確実にしたい場合は、

MesloLGS NF

を使用するのが簡単です。

14. Oh My Zshのプラグイン

Oh My Zshでは .zshrc の、

plugins=(git)

という部分でプラグインを設定できます。

例えば、

plugins=(
  git
  sudo
)

とできます。

変更後は、

exec zsh

でZshを再起動します。

15. autosuggestionsとsyntax highlightingも追加する

さらに使いやすくしたい場合には、

zsh-autosuggestions
zsh-syntax-highlighting

も便利です。

zsh-autosuggestions

git clone https://github.com/zsh-users/zsh-autosuggestions \
"${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions"

zsh-syntax-highlighting

git clone https://github.com/zsh-users/zsh-syntax-highlighting.git \
"${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting"

.zshrc を、

plugins=(
  git
  sudo
  zsh-autosuggestions
  zsh-syntax-highlighting
)

のように変更します。

その後、

exec zsh

します。

16. `.zshrc` の例

最終的な .zshrc の主要部分は、例えば次のようになります。

# Path to your Oh My Zsh installation.
export ZSH="$HOME/.oh-my-zsh"

# Powerlevel10k
ZSH_THEME="powerlevel10k/powerlevel10k"

# Oh My Zsh plugins
plugins=(
  git
  sudo
  zsh-autosuggestions
  zsh-syntax-highlighting
)

source $ZSH/oh-my-zsh.sh

# Powerlevel10k configuration
[[ ! -f ~/.p10k.zsh ]] || source ~/.p10k.zsh

実際にはPowerlevel10kのInstant Prompt関連の記述なども追加されるため、p10k configure が生成した内容は基本的にそのまま残しておくことをおすすめします。

17. Powerlevel10kのアップデート

Oh My Zshのカスタムテーマとしてインストールした場合、

git -C \
"${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k" \
pull

でPowerlevel10kを更新できます。

更新後は、

exec zsh

でZshを再起動します。

18. Oh My Zshのアップデート

Oh My Zshは、

omz update

で更新できます。

19. UbuntuでZshにならない場合

設定したのにBashのままの場合は、

echo $SHELL

を確認します。

まだ、

/bin/bash

となっていたら、

chsh -s "$(which zsh)"

を実行し直します。

その後、ターミナルを閉じるだけではなく、一度ログアウトしてログインし直します。

20. 設定をバックアップする

別のPCでも同じPowerlevel10k設定を使いたい場合は、

~/.zshrc
~/.p10k.zsh

を保存しておくと便利です。

例えばGitHubのdotfilesリポジトリなどで管理しておけば、

Mac
Ubuntu
リモートワークステーション

などでほぼ同じZsh環境を構築できます。

ただし、

~/.oh-my-zsh

そのものをバックアップするよりも、

.zshrc
.p10k.zsh

だけを管理し、Oh My ZshやPowerlevel10k自体は各PCでインストールし直すほうが扱いやすいと思います。

21. macOS / Ubuntu の違いまとめ

項目	macOS	Ubuntu
Zsh	標準搭載	`apt install zsh`
デフォルトシェル	通常Zsh	`chsh` が必要
Oh My Zsh	共通	共通
Powerlevel10k	共通	共通
推奨フォント	MesloLGS NF	MesloLGS NF
ユーザーフォント	Font Book等	`~/.local/share/fonts`
設定ファイル	`~/.zshrc`	`~/.zshrc`
p10k設定	`~/.p10k.zsh`	`~/.p10k.zsh`

結局、OSによって違うのは主に、

Zshのインストール
フォントのインストール
ターミナル側のフォント設定

くらいです。

Oh My Zsh以降については、macOSとUbuntuでほぼ同じ手順を使用できます。

まとめ

最低限必要な操作だけまとめると、Ubuntuでは、

sudo apt update
sudo apt install -y zsh git curl

chsh -s "$(which zsh)"

ログインし直して、

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

Powerlevel10kをインストールします。

git clone --depth=1 \
https://github.com/romkatv/powerlevel10k.git \
"${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k"

.zshrc を、

ZSH_THEME="powerlevel10k/powerlevel10k"

に変更。

Nerd Fontとして、

MesloLGS NF

をインストールしてターミナル側でも指定し、

exec zsh
p10k configure

を実行すれば完成です。

macOSの場合は、もともとZshが入っているため、基本的には Oh My Zshのインストールから始めればOKです。

Powerlevel10kでアイコンが表示されない場合は、まずPowerlevel10kの設定そのものよりも、

ターミナルで MesloLGS NF が使用されているか

を確認するのがポイントです。

参考

Oh My Zsh 公式サイト
Powerlevel10k GitHub
Zsh Documentation

macOS / Ubuntu で Zsh + Oh My Zsh + Powerlevel10k 環境を構築する

はじめに

ターミナル環境を見やすく、使いやすくするために、

Zsh
Oh My Zsh
Powerlevel10k
Nerd Font

を導入します。

この記事では macOS と Ubuntu の両方について、ZshのインストールからPowerlevel10kの設定までまとめます。

最終的には、例えば次のような情報をプロンプトに表示できるようになります。

OSやホストを表すアイコン
ホームディレクトリや現在のディレクトリ
Gitブランチ
Gitの変更状態
Python仮想環境
コマンドの終了ステータス

特にPowerlevel10kでは特殊なアイコンを多数使用するため、Nerd Fontの設定が重要です。

1. 全体の構成

今回構築する環境は次のようになります。

Terminal
  └── Zsh
       └── Oh My Zsh
            └── Powerlevel10k

さらに、アイコンを正しく表示するために、

MesloLGS NF

というNerd Fontをターミナルに設定します。

大まかな流れは、

1. Zshをインストール
2. Zshをデフォルトシェルにする
3. Oh My Zshをインストール
4. Powerlevel10kをインストール
5. Nerd Fontをインストール
6. ターミナルでNerd Fontを指定
7. p10k configure を実行

です。

2. macOSの場合

2.1 Zshの確認

現在のmacOSではZshが標準でインストールされているため、まず確認します。

zsh --version

例えば、

zsh 5.x.x (...)

のように表示されればOKです。

使用中のシェルも確認できます。

echo $SHELL

/bin/zsh

となっていれば、すでにZshがデフォルトシェルです。

その場合、Zshを追加でインストールする必要はありません。

Homebrew版Zshを使用したい場合

Homebrew版を使いたい場合は、

brew install zsh

でもインストールできます。

ただし、特に理由がなければmacOS標準のZshで十分です。

3. Ubuntuの場合

UbuntuではZshをインストールします。

sudo apt update
sudo apt install -y zsh git curl

インストールを確認します。

zsh --version

Zshの場所も確認します。

which zsh

通常は、

/usr/bin/zsh

となります。

3.1 Zshをデフォルトシェルにする

Ubuntuでは、

chsh -s "$(which zsh)"

を実行します。

確認します。

grep "$USER" /etc/passwd

末尾が、

/usr/bin/zsh

になっていれば設定されています。

一度ログアウトして、再度ログインします。

その後、

echo $SHELL

を実行して、

/usr/bin/zsh

となっていればOKです。

4. Oh My Zshのインストール

macOS / Ubuntuともに、ここからはほぼ同じです。

Oh My Zshをインストールします。

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

インストールが完了すると、

~/.oh-my-zsh

が作成されます。

また、

~/.zshrc

も作成されます。

確認してみます。

ls -la ~ | grep zsh

5. Powerlevel10kのインストール

Powerlevel10kをOh My Zshのカスタムテーマディレクトリにcloneします。

git clone --depth=1 \
  https://github.com/romkatv/powerlevel10k.git \
  "${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k"

次に、

nano ~/.zshrc

などで .zshrc を開きます。

次の行を探します。

ZSH_THEME="robbyrussell"

これを、

ZSH_THEME="powerlevel10k/powerlevel10k"

に変更します。

保存したらZshを起動し直します。

exec zsh

初回起動時にはPowerlevel10kの設定ウィザードが起動します。

起動しない場合は、

p10k configure

を実行します。

6. Nerd Fontをインストールする

Powerlevel10kでは、

フォルダ
Git
Home
OS
各種ステータス

などをアイコンで表示します。

通常のフォントではこれらの文字を持っていないことがあるため、Nerd Fontを使用します。

Powerlevel10kで推奨されているのが、

MesloLGS NF

です。

必要なのは基本的に次の4フォントです。

MesloLGS NF Regular
MesloLGS NF Bold
MesloLGS NF Italic
MesloLGS NF Bold Italic

7. macOSにMesloLGS NFをインストール

例えば次のようにダウンロードします。

mkdir -p ~/Downloads/MesloLGS-NF
cd ~/Downloads/MesloLGS-NF

curl -fLo "MesloLGS NF Regular.ttf" \
"https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Regular.ttf"

curl -fLo "MesloLGS NF Bold.ttf" \
"https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Bold.ttf"

curl -fLo "MesloLGS NF Italic.ttf" \
"https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Italic.ttf"

curl -fLo "MesloLGS NF Bold Italic.ttf" \
"https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Bold%20Italic.ttf"

Finderから各 .ttf ファイルを開いて、

インストール

を選択します。

8. UbuntuにMesloLGS NFをインストール

Ubuntuではユーザー用フォントディレクトリ、

~/.local/share/fonts

に入れるのがおすすめです。

mkdir -p ~/.local/share/fonts
cd ~/.local/share/fonts

フォントをダウンロードします。

wget \
"https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Regular.ttf"

wget \
"https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Bold.ttf"

wget \
"https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Italic.ttf"

wget \
"https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Bold%20Italic.ttf"

フォントキャッシュを更新します。

fc-cache -fv

インストールされたか確認します。

fc-list | grep "MesloLGS NF"

表示されればOKです。

`~/.fonts` でもよい？

以前は、

~/.fonts

もよく使われていました。

現在は、

~/.local/share/fonts

を使用するほうがよいでしょう。

9. ターミナル側のフォントを変更する

フォントをOSへインストールしただけでは、Powerlevel10kのアイコンが正しく表示されないことがあります。

実際に使用しているターミナルのフォントを MesloLGS NF に変更します。

ここがかなり重要です。

macOS Terminal

Terminalの設定から、

Terminal
  → Settings
  → Profiles
  → Text
  → Font

を開き、

MesloLGS NF

を指定します。

iTerm2

iTerm2の場合は、

Settings
  → Profiles
  → Text
  → Font

から、

MesloLGS NF

を指定します。

Ghostty

Ghosttyでは設定ファイルに、

font-family = "MesloLGS NF"

を指定します。

macOS/Linuxともに、設定を反映したあとGhosttyを再起動します。

GNOME Terminal

Ubuntu標準のGNOME Terminalの場合、

Preferences
 → Profile
 → Text
 → Custom font

を有効にして、

MesloLGS NF

を選択します。

VS Code

VS CodeのIntegrated TerminalでもPowerlevel10kを使用する場合は、

"terminal.integrated.fontFamily": "MesloLGS NF"

を設定します。

10. Powerlevel10kの初期設定

フォントを設定した状態で、

p10k configure

を実行します。

Powerlevel10kの設定ウィザードが開始されます。

最初に、

Does this look like a diamond?

など、特殊文字が正常に見えているか確認されます。

正常に表示されていれば、

Yes

を選択します。

その後、

Prompt Style
Character Set
Show Current Time?
Prompt Separators
Prompt Heads
Prompt Tails
Prompt Height
Prompt Connection
Prompt Frame
Prompt Spacing
Icons
Prompt Flow
Transient Prompt
Instant Prompt

などを対話形式で設定できます。

特にこだわりがなければ、プレビューを見ながら好きなものを選んでいけば問題ありません。

11. Powerlevel10kの設定ファイル

設定ウィザードを完了すると、

~/.p10k.zsh

が作成されます。

.zshrc の末尾付近には通常、

[[ ! -f ~/.p10k.zsh ]] || source ~/.p10k.zsh

が追加されます。

したがって構成としては、

~/.zshrc
    ↓
~/.p10k.zsh

となっています。

Powerlevel10kの細かい表示を変更したい場合は、

nano ~/.p10k.zsh

などで編集できます。

12. Powerlevel10kを再設定する

デザインを変更したくなった場合は簡単です。

p10k configure

をもう一度実行します。

設定ウィザードが最初から起動します。

例えば、

アイコンを増やしたい
1行表示から2行表示に変更したい
Git情報の見え方を変えたい
Unicode表示がおかしいので再設定したい

といった場合に便利です。

13. AppleマークやHomeアイコンが表示されない場合

Powerlevel10kは動いているのに、



やHome、Gitなどのアイコンが表示されず、

□

や文字化けになってしまうことがあります。

この場合、Powerlevel10kそのものではなく、フォント設定が原因であることが多いです。

まず、

p10k configure

を実行します。

最初の特殊文字確認で正しく表示されなければ、ターミナルのフォントを確認します。

使用しているフォントが、

MesloLGS NF

になっていることを確認します。

単に、

Meslo

や、

Migu 1M

などを指定しただけでは、Powerlevel10kで使用するNerd Fontのアイコンがすべて表示できるとは限りません。

Powerlevel10kのアイコン表示を確実にしたい場合は、

MesloLGS NF

を使用するのが簡単です。

14. Oh My Zshのプラグイン

Oh My Zshでは .zshrc の、

plugins=(git)

という部分でプラグインを設定できます。

例えば、

plugins=(
  git
  sudo
)

とできます。

変更後は、

exec zsh

でZshを再起動します。

15. autosuggestionsとsyntax highlightingも追加する

さらに使いやすくしたい場合には、

zsh-autosuggestions
zsh-syntax-highlighting

も便利です。

zsh-autosuggestions

git clone https://github.com/zsh-users/zsh-autosuggestions \
"${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions"

zsh-syntax-highlighting

git clone https://github.com/zsh-users/zsh-syntax-highlighting.git \
"${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting"

.zshrc を、

plugins=(
  git
  sudo
  zsh-autosuggestions
  zsh-syntax-highlighting
)

のように変更します。

その後、

exec zsh

します。

16. `.zshrc` の例

最終的な .zshrc の主要部分は、例えば次のようになります。

# Path to your Oh My Zsh installation.
export ZSH="$HOME/.oh-my-zsh"

# Powerlevel10k
ZSH_THEME="powerlevel10k/powerlevel10k"

# Oh My Zsh plugins
plugins=(
  git
  sudo
  zsh-autosuggestions
  zsh-syntax-highlighting
)

source $ZSH/oh-my-zsh.sh

# Powerlevel10k configuration
[[ ! -f ~/.p10k.zsh ]] || source ~/.p10k.zsh

実際にはPowerlevel10kのInstant Prompt関連の記述なども追加されるため、p10k configure が生成した内容は基本的にそのまま残しておくことをおすすめします。

17. Powerlevel10kのアップデート

Oh My Zshのカスタムテーマとしてインストールした場合、

git -C \
"${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k" \
pull

でPowerlevel10kを更新できます。

更新後は、

exec zsh

でZshを再起動します。

18. Oh My Zshのアップデート

Oh My Zshは、

omz update

で更新できます。

19. UbuntuでZshにならない場合

設定したのにBashのままの場合は、

echo $SHELL

を確認します。

まだ、

/bin/bash

となっていたら、

chsh -s "$(which zsh)"

を実行し直します。

その後、ターミナルを閉じるだけではなく、一度ログアウトしてログインし直します。

20. 設定をバックアップする

別のPCでも同じPowerlevel10k設定を使いたい場合は、

~/.zshrc
~/.p10k.zsh

を保存しておくと便利です。

例えばGitHubのdotfilesリポジトリなどで管理しておけば、

Mac
Ubuntu
リモートワークステーション

などでほぼ同じZsh環境を構築できます。

ただし、

~/.oh-my-zsh

そのものをバックアップするよりも、

.zshrc
.p10k.zsh

だけを管理し、Oh My ZshやPowerlevel10k自体は各PCでインストールし直すほうが扱いやすいと思います。

21. macOS / Ubuntu の違いまとめ

項目	macOS	Ubuntu
Zsh	標準搭載	`apt install zsh`
デフォルトシェル	通常Zsh	`chsh` が必要
Oh My Zsh	共通	共通
Powerlevel10k	共通	共通
推奨フォント	MesloLGS NF	MesloLGS NF
ユーザーフォント	Font Book等	`~/.local/share/fonts`
設定ファイル	`~/.zshrc`	`~/.zshrc`
p10k設定	`~/.p10k.zsh`	`~/.p10k.zsh`

結局、OSによって違うのは主に、

Zshのインストール
フォントのインストール
ターミナル側のフォント設定

くらいです。

Oh My Zsh以降については、macOSとUbuntuでほぼ同じ手順を使用できます。

まとめ

最低限必要な操作だけまとめると、Ubuntuでは、

sudo apt update
sudo apt install -y zsh git curl

chsh -s "$(which zsh)"

ログインし直して、

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

Powerlevel10kをインストールします。

git clone --depth=1 \
https://github.com/romkatv/powerlevel10k.git \
"${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k"

.zshrc を、

ZSH_THEME="powerlevel10k/powerlevel10k"

に変更。

Nerd Fontとして、

MesloLGS NF

をインストールしてターミナル側でも指定し、

exec zsh
p10k configure

を実行すれば完成です。

macOSの場合は、もともとZshが入っているため、基本的には Oh My Zshのインストールから始めればOKです。

Powerlevel10kでアイコンが表示されない場合は、まずPowerlevel10kの設定そのものよりも、

ターミナルで MesloLGS NF が使用されているか

を確認するのがポイントです。

参考

Oh My Zsh 公式サイト
Powerlevel10k GitHub
Zsh Documentation

だけを管理し、Oh My ZshやPowerlevel10k自体は各PCでインストールし直すほうが扱いやすいと思います。

21. macOS / Ubuntu の違いまとめ

項目	macOS	Ubuntu
Zsh	標準搭載	`apt install zsh`
デフォルトシェル	通常Zsh	`chsh` が必要
Oh My Zsh	共通	共通
Powerlevel10k	共通	共通
推奨フォント	MesloLGS NF	MesloLGS NF
ユーザーフォント	Font Book等	`~/.local/share/fonts`
設定ファイル	`~/.zshrc`	`~/.zshrc`
p10k設定	`~/.p10k.zsh`	`~/.p10k.zsh`

結局、OSによって違うのは主に、

Zshのインストール
フォントのインストール
ターミナル側のフォント設定

くらいです。

Oh My Zsh以降については、macOSとUbuntuでほぼ同じ手順を使用できます。

まとめ

最低限必要な操作だけまとめると、Ubuntuでは、

sudo apt update
sudo apt install -y zsh git curl

chsh -s "$(which zsh)"

ログインし直して、

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

Powerlevel10kをインストールします。

git clone --depth=1 \
https://github.com/romkatv/powerlevel10k.git \
"${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k"

.zshrc を、

ZSH_THEME="powerlevel10k/powerlevel10k"

に変更。

Nerd Fontとして、

MesloLGS NF

をインストールしてターミナル側でも指定し、

exec zsh
p10k configure

を実行すれば完成です。

macOSの場合は、もともとZshが入っているため、基本的には Oh My Zshのインストールから始めればOKです。

Powerlevel10kでアイコンが表示されない場合は、まずPowerlevel10kの設定そのものよりも、

ターミナルで MesloLGS NF が使用されているか

を確認するのがポイントです。

参考

Oh My Zsh 公式サイト
Powerlevel10k GitHub
Zsh Documentation