0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【完全ガイド】Mac + nvm で Node.js のバージョンを自由に管理する方法

Posted at

複数のプロジェクトで異なる Node.js バージョンが必要になった経験はありませんか?
そんなときに便利なのが **nvm(Node Version Manager)**です。

この記事では以下のことをすべてカバーします:

  • nvm のインストール(Homebrew)
  • 利用可能な Node.js バージョン一覧表示
  • 任意のバージョン選定・インストール
  • pnpm, TypeScript のグローバルインストール
  • プロジェクトごとのバージョン固定(.nvmrc
  • VSCodeとの連携
  • バージョンの切り替え

🛠 1. nvm のインストール(Homebrew 使用)

brew install nvm

インストール後、以下を ~/.zshrc または ~/.bashrc に追加:

export NVM_DIR="$HOME/.nvm"
[ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && \. "/opt/homebrew/opt/nvm/nvm.sh"
[ -s "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm" ] && \. "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm"

反映:

source ~/.zshrc  # または source ~/.bashrc

🔍 2. インストール可能な Node.js バージョン一覧を表示

nvm ls-remote

LTS(長期サポート)だけを表示:

nvm ls-remote --lts

📦 3. 任意の Node.js バージョンをインストール

nvm install 20.19.2      # 例:安定版 LTS の Node.js をインストール
nvm use 20.19.2          # 使用するバージョンを切り替え
nvm alias default 20.19.2  # デフォルトに設定(ログイン時に自動で切り替え)

確認:

node -v
npm -v

📦 4. グローバルパッケージ(pnpm / TypeScript)をインストール

npm install -g pnpm typescript

確認:

pnpm -v
tsc -v

📁 5. プロジェクトごとに Node.js バージョンを固定(.nvmrc

プロジェクトルートに .nvmrc ファイルを作成:

echo "20.19.2" > .nvmrc

そのプロジェクトに入ったら:

nvm use  # .nvmrc を読み取って自動で切り替え

🧩 6. VSCode との連携(Nodeバージョン認識)

VSCode を開いても nvm のバージョンが使われない場合は、VSCode のターミナルで which node を実行し、~/.nvm/... のパスであることを確認してください。

もし反映されていない場合は:

  1. VSCode を再起動
  2. code ~/.zshrc で nvm の設定が入っているか確認
  3. VSCode の「ターミナル」→「新しいターミナル」で再確認

また、プロジェクトごとに settings.json で以下を追加しておくと便利です:

{
  "typescript.tsdk": "node_modules/typescript/lib",
  "terminal.integrated.defaultProfile.osx": "zsh"
}

🔁 7. バージョンの切り替え

バージョン一覧を確認:

nvm ls

使用するバージョンを切り替え:

nvm use 22.16.0

別バージョンのインストール:

nvm install 22.16.0

削除:

nvm uninstall 22.16.0

✅ おわりに

nvm を使えば、Node.js のバージョン切り替えが超スムーズになります。

複数プロジェクトを扱う方、バージョン差異でのバグに悩まされていた方にとっては必須級のツールです。


🚀 参考リンク

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?