nodist で Windows のローカル開発環境に npm を導入する手順
Windows PC に npm をインストールする手順をまとめておきます。
頻繁に行わない操作なので「なんだっけ?」となることが(私は、、、)多いのでまとめてみました。
導入するツール
nodist とは?
Windows PC のローカルにインストールする node.js のバージョン管理ができるツールです。今回はこの nodist を利用します。
node.js 、 npm だけ導入するなら、 node.js のインストーラを使うだけでもいいと思います。nodist はローカルPCにインストールする node.js のバージョンを管理することができます。
具体的には、バージョンを 8 にしたり 10 にしたりとカチカチ切り替えができます。 ruby で言うところの rbenv です。
このバージョンの管理はコマンドラインから行うことができます。この記事ではインストールのみを書いています。
導入するツール一覧
今回導入する手順をまとめたのは以下になります。
- nodist
- node.js
- npm
インストール手順
nodist のインストール後はコマンドラインを使います。この記事内では「Git bash」を使っています。先頭に $
があるが実行したコマンドです。「cmd.exe」でもよいですが、そういう前提で書きましたよ、ということです。
nodist
前述したとおり、 node.js のバージョン管理ができるツールです。
1. インストーラーをダウンロード
ここにある最新のバージョンの exe をダウンロードします。
2. exeを実行し、インストール
インストーラに従うのみです。
3. インストールの確認
バージョン確認します。
$ nodist -v 0.9.1
node.js
nodist でインストールを行います。
1. インストールしたいバージョンを確認
通常は LTS (Long Term Support) のバージョンを選ぶのが無難でしょう。公式サイトを覗いて確認します。
2. インストールできるnodeを確認
nodist で利用できるバージョンを見ておきます。
$ nodist dist 0.1.14 0.1.15 ... 10.15.3 10.16.0 ... 12.6.0 12.7.0
インストールしたい 10.16.0
がありました。
3. バージョンを選択しインストール
$ nodist 10.16.0 10.16.0 Installing 10.16.0 10.16.0 [===============] 25457/25457 KiB 100% 0.0s Installation successful.
4. インストールを確認
$ nodist list (x64) 8.9.1 8.11.4 10.15.0 > 10.16.0 (global: 10.16.0) 11.13.0
のように、指定したバージョンが > 10.16.0 (global: 10.16.0)
として表示されればOK。(この例では過去にインストールしたバージョンも表示されています。)
npm のアップデート
上記の通りにインストールすると、インストールした node.js に対応した npm が使えるようになっています。ここでは、あえて npm を最新にする方法を書いておきます。
nodist を使ったインストールでは npm のバージョンは別途変更する必要があるようです。以下の手順に従って npm を最新化しておきましょう。
(変更 : 2020/12/21)
1. インストール対象を確認
公式サイトより Node.js に対応する npm のバージョンを確認します。
(追記 : 2020/12/21)
2. バージョンの確認
$ npm --version 6.9.0
3. アップデートを実行
$ npm install -g npm
$ nodist npm 6.14.9 npm 6.14.9 https://codeload.github.com/npm/cli/tar.gz/v6.14.9 [=========== ] 4368/5832 KiB 74% 1.6s
(変更 : 2020/12/21)
4. 再度バージョンを確認
$ npm --version 6.10.2
今回は変化がありましたが、バージョンが変わらない場合もあります。
$ npm -v 6.14.9
(変更 : 2020/12/21)
nodist で管理されているバージョンも確認します。
$ nodist npm list 6.9.0 > 6.14.9 (global: 6.14.9)
(追記 : 2020/12/21)
5. npx をインストール
通常は自動で npx がインストールされるのですが、 nodist のコレまでの操作ではうまくインストールされない問題があるようです。そのため、 npx のインストールも行います。
$ npm install npx -g C:\Program Files (x86)\Nodist\bin\npx -> C:\Program Files (x86)\Nodist\bin\node_modules\npx\index.js + npx@10.2.2 added 493 packages from 654 contributors in 17.501s $ npx -v 10.2.2
(追記 : 2020/12/21)
以上です。
変更履歴
2020/12/21
「npm のアップデート」の方法を変更しました。 npm install -g npm
から nodist npm 6.14.9
という、 nodist を利用した方法に記載を変更しています。
npx も別途インスールが必要な件も悩まされました。node のバージョンを14に変更したあたりから挙動が不審になりました。。。で、調べてみると同じような状態になっている人はたくさんいました。下記の記事を最初に参考にしました。大変助かりました。引き続き調べてみたら、他の記事でも言及されているようですね。
2021/02/12
ページ先頭に nodist の利用を諦めた記事のリンクを追記しました。