mise 入門 - 開発ツールのバージョン管理を簡単にする

mise とは

mise（読み方: ミーズ）は、開発ツールのバージョン管理を行うためのツールです。正式名称は mise-en-place（ミーズ・オン・プラス）で、フランス料理の「準備を整える」を意味する用語に由来します。Node.js、Python、Ruby など、複数のプログラミング言語やツールのバージョンを簡単に切り替えられます。

公式サイト: https://mise.jdx.dev

従来のツールの課題

開発をしていると、プロジェクトごとに異なるバージョンのツールが必要になることがあります。

• プロジェクト A では Node.js 22 を使用
• プロジェクト B では Node.js 24 を使用

従来は、言語ごとに別々のバージョン管理ツールを使う必要がありました。

これでは、ツールごとに使い方を覚える必要があり、設定も複雑になりがちです。

mise の機能

mise は以下の複数の機能を 1 つのツールで提供します。

1. ツールのバージョン管理: Node.js、Python、Ruby など、多数のツールに対応
2. プロジェクトごとの自動切り替え: ディレクトリに入ると自動でバージョンが切り替わる
3. 環境変数の管理: プロジェクトごとに環境変数を設定できる

インストール

mise をインストールする方法はいくつかあります。お使いの環境に合わせて選んでください。

macOS / Linux

curl（カール）コマンドを使う方法が最も簡単です。curl は URL からデータをダウンロードするコマンドで、多くの環境に標準でインストールされています。ターミナルで以下のコマンドを実行してください。

# mise をインストール（~/.local/bin にインストールされる）
curl https://mise.run | sh

インストールが完了したら、mise が正しくインストールされたか確認します。

# バージョンを確認
~/.local/bin/mise --version

Homebrew を使う場合

macOS で Homebrew を使っている場合は、以下のコマンドでもインストールできます。

# Homebrew で mise をインストール
brew install mise

Homebrew でインストールした場合、mise は自動的に PATH に追加されます。

Windows

Windows では Scoop または winget を使ってインストールできます。

# Scoop を使う場合（推奨）
scoop install mise

# winget を使う場合
winget install jdx.mise

シェルへの設定（アクティベーション）

mise をインストールしただけでは、ツールのバージョン自動切り替え機能は有効になりません。シェル（ターミナルで使うコマンド入力環境）に mise を登録する必要があります。これにより、ディレクトリを移動した際に mise が自動でツールのバージョンを切り替えられるようになります。

この設定を「アクティベーション」と呼びます。

Bash の場合

# ~/.bashrc に mise のアクティベーション設定を追加
echo 'eval "$(~/.local/bin/mise activate bash)"' >> ~/.bashrc

設定を反映するために、ターミナルを再起動するか、以下のコマンドを実行します。

# 設定を再読み込み
source ~/.bashrc

Zsh の場合

macOS のデフォルトシェルは Zsh です。

# ~/.zshrc に mise のアクティベーション設定を追加
echo 'eval "$(~/.local/bin/mise activate zsh)"' >> ~/.zshrc

設定を反映します。

# 設定を再読み込み
source ~/.zshrc

PowerShell の場合

PowerShell を使っている場合は、以下のコマンドを実行します。

# PowerShell のプロファイルに mise のアクティベーション設定を追加
echo '(&mise activate pwsh) | Out-String | Invoke-Expression' >> $PROFILE

設定を反映するために、PowerShell を再起動するか、以下のコマンドを実行します。

# 設定を再読み込み
. $PROFILE

設定の確認

mise が正しく設定されているか確認するには、mise doctor コマンドを使います。

# mise の設定状態を診断
mise doctor

問題がなければ、mise を使う準備は完了です。

基本的な使い方

ツールのインストールと有効化

mise でツールをインストールして使えるようにするには、mise use コマンドを使います。

# Node.js 24 をインストールしてプロジェクトで使用する
mise use node@24

このコマンドを実行すると、以下の処理が行われます。

1. Node.js 24 の最新バージョンがインストールされる
2. 現在のディレクトリに mise.toml ファイルが作成される
3. このディレクトリで Node.js 24 が使えるようになる

グローバル設定とプロジェクト設定

mise には 2 種類の設定があります。

# グローバル設定として Node.js 24 を設定
mise use -g node@24

# プロジェクト設定として Node.js 22 を設定（現在のディレクトリのみ）
mise use node@22

プロジェクト設定はグローバル設定より優先されます。つまり、プロジェクトディレクトリに入ると、そのプロジェクト用のバージョンに自動で切り替わります。

バージョンの確認と切り替え

現在インストールされているツールとバージョンを確認するには、mise ls コマンドを使います。

# インストール済みの全ツールを表示
mise ls

# 現在のディレクトリで有効なバージョンのみ表示
mise ls --current

特定のバージョンを一時的に使いたい場合は、mise exec コマンドが便利です。

# Node.js 22 で一時的にスクリプトを実行
# 「--」の後ろに実行したいコマンドを書く
mise exec node@22 -- node ./app.js

設定ファイル（mise.toml）

mise use コマンドを実行すると、現在のディレクトリに mise.toml ファイルが作成されます。このファイルを直接編集することもできます。

基本構文

# mise.toml の基本的な書き方

[tools]
# ツール名 = "バージョン" の形式で指定
node = "24"

複数ツールの指定

1 つのプロジェクトで複数のツールを使う場合は、[tools] セクションに並べて書きます。

[tools]
# Node.js 24 の最新版を使用
node = "24"

# Python 3.14 の最新版を使用
python = "3.14"

# shellcheck は常に最新版を使用
shellcheck = "latest"

バージョンの指定方法には以下の種類があります。

# 正確なバージョンを mise.toml に記録
mise use --pin node@24

環境変数の設定

mise では、プロジェクトごとに環境変数を設定することもできます。

[tools]
node = "24"

[env]
# 環境変数を設定
NODE_ENV = "development"
API_URL = "http://localhost:3000"

# PATH に追加のディレクトリを含める（_.path は mise 独自の特殊記法）
_.path = "./node_modules/.bin"

[env] セクションに書いた環境変数は、そのディレクトリに入ると自動的に設定されます。

よく使うコマンド一覧

まとめ

この記事では、mise の基本的な使い方を解説しました。

• mise とは: 複数の開発ツールのバージョンを一元管理できるツール
• インストール: curl https://mise.run | sh で簡単にインストール可能
• アクティベーション: シェルの設定ファイルに追記して自動切り替えを有効化
• 基本的な使い方: mise use でツールをインストール・有効化
• 設定ファイル: mise.toml でツールのバージョンや環境変数を管理

mise を使うことで、プロジェクトごとに異なるバージョンのツールを簡単に切り替えられるようになります。チーム開発では、mise.toml をリポジトリに含めることで、全員が同じ環境で開発できます。

参考リンク

• mise 公式ドキュメント
• mise GitHub リポジトリ