Linuxes

mise installしてもコマンドの実体が切り替わらない mise.tomlにツールを記述してmise installを実行しても、シェルで直接コマンド名を打ったときに使われる実体は自動的には切り替わらない。jqのようにシステムにも同名のコマンドがインストール済みの場合、そちらが優先されたままになる。mise activateをシェルに組み込むと、ディレクトリごとにmise.tomlで指定したバージョンへコマンドの解決先が自動的に切り替わる。

asdfから移行するときに.tool-versionsを書き換えたくない asdfはプロジェクトで使うツールのバージョンを.tool-versionsというファイルで管理する。miseは.tool-versionsをそのまま読み込めるため、asdfからmiseへ移行する際に.tool-versionsを書き換える必要はない。

mise.tomlに何を書けるのか把握したい miseはプロジェクトで使うツールのバージョンや環境変数、タスクをmise.tomlという設定ファイルで管理する。mise.tomlには[tools]以外にもいくつかのセクションがあり、書ける内容やファイルの置き場所にはルールがある。

miseは、プロジェクトごとに使うツールのバージョンをmise.tomlで管理するツールである。1つのコマンドが担う役割は小さく分かれているため、目的に応じたコマンドを個別に把握しておくと使いやすい。ここではmiseの主要なコマンドを目的別に整理し、それぞれの使い方を解説した記事へリンクする。

ビルドやテストのコマンドをmise.tomlにまとめて管理したい プロジェクトごとに使うnpm run buildやmake testのようなコマンドを、READMEやシェルスクリプトへ散らばらせずmise.tomlにまとめて定義しておきたい場合がある。miseはmise.tomlにタスクを定義し、mise runで実行できるタスクランナー機能を備えている。

初めて開いたプロジェクトでmiseコマンドがエラーになる mise.tomlは環境変数の設定やタスクの定義など、コードの実行や環境に影響する内容を含められる。知らないリポジトリのmise.tomlをそのまま読み込んでしまうと、意図しないコードの実行につながるおそれがある。そのためmiseはこのような設定ファイルを未信頼(untrusted)として扱い、読み込む前にmise trustによる明示的な信頼を求める。

miseが正しく動作しているか確認したい mise useやmise installを実行したのに意図したバージョンが使われない、といった場合、miseの設定やPATHの状態を1つずつ確認するのは手間がかかる。mise doctorを実行すると、miseの動作状況をまとめて確認でき、問題があれば警告として教えてくれる。

miseが管理するコマンドの実行ファイルがどこにあるか確認したい ターミナルでOSのwhichコマンドを使っても、PATHの設定状況によっては、mise管理下のバージョンとは別の場所にインストールされた同名のコマンドを指す場合がある。mise whichを使うと、mise管理下で実際に使われる実行ファイルのパスを確実に確認できる。

miseがインストールしたツールの実体がどこにあるか確認したい miseはmise installでツールをダウンロードすると、独自の管理ディレクトリ配下でバージョンごとにインストールする。インストール先のパスを直接知りたい場合、mise whereを使うとツールのインストールディレクトリを確認できる。

カレントディレクトリで実際に使われているバージョンだけを確認したい mise lsは設定ファイルの場所やインストール状況まで含めた一覧を表示するが、単純に「今このディレクトリで有効なバージョンは何か」だけを知りたい場合は情報が多すぎる。mise currentを使うと、カレントディレクトリで現在有効なツールとバージョンだけをシンプルに表示できる。