asdfで一元管理！複数プログラミング言語のバージョンを効率よく管理する方法

asdfとは

asdfは、Ruby, Python, Node.js など、複数のプログラミング言語やツールのバージョンを一元管理できるバージョン管理ツールです。

従来は言語ごとにrbenv（Ruby用）、pyenv（Python用）、nvm（Node.js用）などのツールを使い分ける必要がありましたが、それらを利用しなくてもasdfだけで一元管理できるため、環境構築や切り替えが非常に簡単になります

導入方法

1. asdfのインストール

まずはHomebrewを使ってasdfをインストールします。

brew install asdf

次に、利用しているシェルに応じてパスを設定します。

# 利用しているシェルの確認
echo $SHELL

例えば、zshを使用している場合は、~/.zshrcに以下の設定を追加します。

export PATH="${ASDF_DATA_DIR:-$HOME/.asdf}/shims:$PATH"

その他のシェルについては、こちらの公式ガイドを参考に設定してください。

インストールが正常に完了したか確認するため、以下のコマンドでバージョンが表示されることを確認します。

asdf -v

バージョンが表示されない場合、設定の見直しやシェルの再起動を試してください。

2. プラグインの追加とバージョン管理

asdfでは、各言語やツールのバージョンを管理するために、プラグインを追加する必要があります。インストールできるプラグインは、以下コマンドで確認できます。

asdf plugin list all

ここでは、Node.jsの管理を例に説明します。

2-1. プラグインのインストール

Node.jsのプラグインを追加するには、以下のコマンドを実行します。

asdf plugin add nodejs

プラグインが正常にインストールされたか確認するには、以下のコマンドを使います。

asdf list

2-2. インストールしたいバージョンを指定

Node.jsのインストール可能なバージョンを確認するには、以下のコマンドを使います。

asdf list all nodejs

使いたいバージョンをインストールします。

# 最新バージョンをインストールする場合
asdf install nodejs latest
# 特定のバージョンを指定してインストールする場合
asdf install nodejs 23.11.0

2-3. 利用するバージョンを指定

プロジェクトごとに使うバージョンを設定するには、対象のプロジェクトディレクトリで以下のコマンドを実行します。

asdf set nodejs 23.11.0

このコマンドを実行すると、プロジェクトディレクトリに .tool-versionsファイルが作成され、指定したバージョンが適用されます。
これにより、チーム開発時に .tool-versions ファイルを共有することで、バージョンの統一が簡単になります。

🔔 補足:
該当のプロジェクトだけでなく、グローバルに適用したい場合は、-u オプションを付けて実行します。

asdf set -u nodejs 23.11.0

⚠️ 注意:
asdf を利用する際、バージョン指定の方法として以下のコマンドが紹介されていることがありますが、v0.16.0 以降は利用できなくなったので注意が必要です。
ref. https://asdf-vm.com/guide/upgrading-to-v0-16.html#asdf-global-and-asdf-local-commands-have-been-replaced-with-asdf-set

# 使用不可: v0.16.0 以降
asdf local nodejs 23.11.0
asdf global nodejs 23.11.0

実行例（失敗例）:

asdf local nodejs 23.11.0
invalid command provided: local

version: 0.16.7

MANAGE PLUGINS
asdf plugin add <name> [<git-url>]      Add a plugin from the plugin repo OR,
                                        add a Git repo as a plugin by
                                        specifying the name and repo url
asdf plugin list [--urls] [--refs]      List installed plugins. Optionally show
                                        git urls and git-ref
asdf plugin list all                    List plugins registered on asdf-plugins
                                        repository with URLs
asdf plugin remove <name>               Remove plugin and package versions
asdf plugin update <name> [<git-ref>]   Update a plugin to latest commit on
                                        default branch or a particular git-ref
asdf plugin update --all                Update all plugins to latest commit on
                                        default branch


MANAGE TOOLS
asdf current                            Display current version set or being
                                        used for all packages
asdf current <name>                     Display current version set or being
                                        used for package
asdf help <name> [<version>]            Output documentation for plugin and tool
asdf install                            Install all the package versions listed
                                        in the .tool-versions file
asdf install <name>                     Install one tool at the version
                                        specified in the .tool-versions file
asdf install <name> <version>           Install a specific version of a package
asdf install <name> latest[:<version>]  Install the latest stable version of a
                                        package, or with optional version,
                                        install the latest stable version that
                                        begins with the given string
asdf latest <name> [<version>]          Show latest stable version of a package
asdf latest --all                       Show latest stable version of all the
                                        packages and if they are installed
asdf list <name> [version]              List installed versions of a package and
                                        optionally filter the versions
asdf list all <name> [<version>]        List all versions of a package and
                                        optionally filter the returned versions
asdf set [-u] [-p] <name> <versions...> Set a tool version in a .tool-version in
                                        the current directory, or a parent
                                        directory.
asdf uninstall <name> <version>         Remove a specific version of a package
asdf where <name> [<version>]           Display install path for an installed
                                        or current version
asdf which <command>                    Display the path to an executable


UTILS
asdf exec <command> [args...]           Executes the command shim for current version
asdf env <command> [util]               Runs util (default: `env`) inside the
                                        environment used for command shim execution.
asdf info                               Print OS, Shell and ASDF debug information.
asdf version                            Print the currently installed version of ASDF
asdf reshim <name> <version>            Recreate shims for version of a package
asdf shimversions <command>             List the plugins and versions that
                                        provide a command

RESOURCES
GitHub: https://github.com/asdf-vm/asdf
Docs:   https://asdf-vm.com

PLUGIN nodejs
  asdf nodejs nodebuild
  asdf nodejs resolve
  asdf nodejs update-nodebuild

"Late but latest"
-- Rajinikanth