すでに Node 環境が整っている場合は、クイックスタート に進んでください。

Node.js と npm のインストール

ダウンロード

公式ダウンロードページ https://nodejs.org/en/download/ から、お使いの OS に合ったバージョンを選択してください。LTS 版のダウンロードをおすすめします。

インストール

ダウンロードしたインストーラーをダブルクリックし、次の手順で進めます。

インストールが完了すると、node と npm は /usr/local/bin/ にインストールされます（上の画像は少し古いバージョンのインストーラーのものです。表示や番号はダウンロードしたものと異なる場合がありますので、実際のインストール手順に従ってください）。

ここまでで Node.js と npm のインストールは完了です！

確認

node.js のバージョン情報を確認します。

$  node -v
v22.14.0

バージョン番号が v22 以上であれば、Node.js の環境は問題なく使用できます。

pnpm のインストール

go-admin-ui は依存管理に pnpm を使用しており、リポジトリには pnpm-lock.yaml がコミットされています。 npm や yarn でインストールするとこのロックファイルが無視され、CI と異なるバージョンの依存パッケージがインストールされる可能性があります。

# 方法 1：npm 経由でインストール
$ npm install -g pnpm

# 方法 2：Node 標準の corepack を使用（追加のダウンロード不要）
$ corepack enable

確認：

$  pnpm -v
9.15.1

バージョンが 9 以上であれば問題ありません。