Multi Vitamin & Mineral

Multi Vitamin & Mineral です。プログラムに関することを書いております。

nodist で Windows のローカル開発環境に npm を導入する手順

当該記事では nodist の利用を勧めていましたが、その後下記のような記事を書きました。こちらの記事も参照いただいた上で利用を検討されることをオススメします。 multimineral-tech.com (追記 : 2021/02/12)

Windows PC に npm をインストールする手順をまとめておきます。

頻繁に行わない操作なので「なんだっけ?」となることが(私は、、、)多いのでまとめてみました。

導入するツール

nodist とは?

Windows PC のローカルにインストールする node.js のバージョン管理ができるツールです。今回はこの nodist を利用します。

github.com

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. インストーラーをダウンロード

github.com

ここにある最新のバージョンの exe をダウンロードします。

2. exeを実行し、インストール

インストーラに従うのみです。

3. インストールの確認

バージョン確認します。

$ nodist -v
0.9.1

node.js

nodist でインストールを行います。

1. インストールしたいバージョンを確認

通常は LTS (Long Term Support) のバージョンを選ぶのが無難でしょう。公式サイトを覗いて確認します。

nodejs.org

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 のバージョンを確認します。

nodejs.org

(追記 : 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に変更したあたりから挙動が不審になりました。。。で、調べてみると同じような状態になっている人はたくさんいました。下記の記事を最初に参考にしました。大変助かりました。引き続き調べてみたら、他の記事でも言及されているようですね。

qiita.com

2021/02/12

ページ先頭に nodist の利用を諦めた記事のリンクを追記しました。