Windows での NodeJS のインストール

Node.js を使用して初めて開発し、学習できるように迅速に稼働させたい場合は、次の手順に従って Node.js を Windows 上に直接インストールします。

Note

Node.js をプロフェッショナルとして使用する場合に、パフォーマンス速度とシステム コールの互換性が重要であると考えていて、Linux ワークスペースを活用する Docker コンテナーを実行し、Linux と Windows の両方のビルド スクリプトを管理する必要がないようにしたい場合、Linux 用 Windows サブシステム (より具体的には WSL 2) 上に Node.js をインストールします

Install nvm-windows のインストール, node.js, npm

Windows または WSL のどちらにインストールするかを選択するだけでなく、Node.js をインストールするときには他にも選択することがあります。 バージョンの変更は非常に早いため、バージョン マネージャーを使用することをお勧めします。 多くの場合、作業しているさまざまなプロジェクトのニーズに基づいて、複数の Node.js のバージョンを切り替える必要があります。 ノード バージョン マネージャー (一般的には nvm と呼ばれています) は、複数のバージョンの Node.js をインストールする場合の最も一般的な方法ですが、Mac または Linux にのみ使用でき、Windows ではサポートされていません。 代わりに、nvm-windows をインストールし、それを使用して Node.js と Node Package Manager (npm) をインストールすることをお勧めします。 代替のバージョン マネージャーについても検討する必要があります。次のセクションで説明します。

重要

バージョン マネージャーをインストールする前に、ご利用のオペレーティング システムから Node.js または npm の既存のインストールを削除することをお勧めします。インストールの種類が異なると、奇妙で混乱を招く競合が発生する可能性があるためです。 これには、残っている可能性がある既存の nodejs インストール ディレクトリ (例: "C:\Program Files\nodejs") の削除などが含まれます。 NVM によって生成される symlink は、既存のインストール ディレクトリを (空であっても) 上書きしません。 以前のインストールの削除については、「How to completely remove node.js from Windows」 (Windows から node.js を完全に削除する方法) を参照してください。

警告

NVM は、ユーザーごとにインストールされ、シェルごとに呼び出されるように設計されています。 共有開発者ボックスや、複数のビルド エージェントを含むビルド サーバーに対応するようには設計されていません。 NVM はシンボリック リンクを使って機能します。 共有シナリオで NVM を使うと、そのリンクがユーザーのアプリ データ フォルダーを指すため、問題が発生します。たとえば、ユーザー x が nvm use lts を実行した場合、リンクによってボックス全体のノードがアプリ データ フォルダーを指すようになります。 ユーザー y がノードまたは npm を実行した場合は x のユーザー アカウントの下にあるファイルが実行され、npm -g の場合は x のファイルが変更され、これらは既定では許可されません。 そのため、nvm は 1 つの開発者ボックスに対してのみ指定されます。 これはビルド サーバーにも当てはまります。 2 つのビルド エージェントが同じ VM またはボックス上にある場合、それらが競合して、ビルドで不適切な動作が発生する可能性があります。

  1. windows-nvm リポジトリのインストール手順に従います。 インストーラーを使用することをお勧めしますが、ニーズをより深く理解している場合は、手動インストールを検討することをお勧めします。 インストーラーによって、最新バージョンのリリース ページが参照されます。

  2. 最新リリースの nvm-setup.zip をダウンロードします。

  3. ダウンロードが完了したら、ZIP ファイルを開いて、nvm-setup.exe ファイルを開きます。

  4. Setup-NVM-for-Windows インストール ウィザードの指示に従って、セットアップ手順を行います。たとえば、nvm-windows と Node.js の両方をインストールするディレクトリの選択などがあります。

    NVM for Windows インストール ウィザード

  5. インストールが完了したら、 PowerShell を開き (特権のある管理者アクセス許可を使って開くことをお勧めします)、windows-nvm を使って、現在インストールされている Node のバージョンを一覧表示します (この時点では何もないはずです): nvm ls

    Node のバージョンが表示されていない NVM リスト

  6. Node.js の現在のリリースをインストールします (最新の機能強化をテストするためですが、LTS バージョンよりも問題が発生する可能性が高くなります): nvm install latest

  7. まず、nvm list available を実行して LTS の現在のバージョン番号を調べた後、Node.js の最新の安定した LTS リリースをインストールします (推奨)。次に、nvm install <version>(<version> を、インストールするバージョン番号に置き換えます。たとえば、nvm install 12.14.0) を実行して、そのバージョン番号の LTS をインストールします。

    使用可能なバージョンの NVM リスト

  8. インストールされている Node のバージョンを一覧表示します: nvm ls。先ほどインストールした 2 つのバージョンが表示されるはずです。

    インストールされている Node のバージョンを示す NVM リスト

  9. 必要なバージョン番号の Node.js をインストールしたら、nvm use <version> を入力して、使用するバージョンを選択します (<version> を番号で置き換え、nvm use 12.9.0 のようにします)。

警告

nvm-windows バージョン 1.1.9 でのアクセス拒否の問題。ノード バージョンの切り替えには、管理者特権の PowerShell (管理者として実行) が必要です。 この問題を回避するために、バージョン 1.1.7 を使用することをお勧めします。

  1. プロジェクトに使用する Node.js のバージョンを変更するには、新しいプロジェクト ディレクトリを作成し (mkdir NodeTest)、ディレクトリ cd NodeTest を入力します。次に、<version>を、使用するバージョン番号 (たとえば、v10.16.3) に置き換えて、nvm use <version> を入力します。

  2. npm --version を実行して、インストールされている npm のバージョンを確認します。このバージョン番号は、Node.js の現在のバージョンに関連付けられている npm のバージョンに自動的に変更されます。

代替のバージョン マネージャー

windows-nvm は、現在最も一般的なノード バージョン マネージャーですが、検討すべき代替マネージャーがいくつかあります。

  • nvs (Node Version Switcher) は、クロスプラットフォームの nvm の代わりであり、VS Code との統合が可能です。

  • Volta は LinkedIn チームからの新しいバージョン マネージャーであり、速度の向上とクロスプラットフォーム サポートを特長として挙げています。

(windows-nvm ではなく) Volta をバージョン マネージャーとしてインストールするには、「Getting Started guide」 (入門ガイド) の「Windows Installation」 (Windows へのインストール) セクションを参照し、セットアップ手順に従って Windows インストーラーをダウンロードして実行します。

重要

Volta をインストールする前に、Windows コンピューターで確実に [開発者モード] を有効にする必要があります。

Volta を使用して複数のバージョンの Node.js を Windows にインストールする方法の詳細については、Volta Docs を参照してください。

Visual Studio Code をインストールする

Windows で Node.js を使用して開発するには、Visual Studio CodeNode.js 拡張パック をインストールすることをお勧めします。 これらをすべてインストールするか、または最も役に立つと思われるものを選択します。

Node.js 拡張パックをインストールするには、次の手順を行います。

  1. VS Code で [拡張機能] ウィンドウを開きます (Ctrl + Shift + X)。
  2. [拡張機能] ウィンドウの上部にある検索ボックスに「Node Extension Pack」 (または、お探しの拡張機能の名前) と入力します。
  3. [インストール] を選択します。 インストールが完了すると、拡張機能が [拡張機能] ウィンドウの [有効] フォルダーに表示されます。 新しい拡張機能の説明の横にある歯車アイコンを選択して、設定を無効、アンインストール、または構成することができます。

他にも検討をお勧めする拡張機能として、次のようなものがあります。

  • Debugger for Chrome:Node.js を使用してサーバー側で開発を完了したら、クライアント側を開発してテストする必要があります。 この拡張機能により、ご利用の VS Code エディターと Chrome ブラウザーのデバッグ サービスが統合され、効率がより向上します。
  • 他のエディターからのキーマップ: これらの拡張機能は、別のテキスト エディター (Atom、Sublime、Vim、eMacs、Notepad++ など) から移行する場合に、ご利用の環境を快適に保つのに役立ちます。
  • 設定の同期: GitHub を使用して、異なるインストール間で VS Code の設定を同期させることができます。 複数のコンピューターで作業する場合、この機能によってコンピューター間で環境の一貫性を保つことができます。

代替コード エディター

Visual Studio Code 以外のコード エディターまたは IDE を使用する場合は、以下のオプションが Node.js 開発環境に適しています。

Git をインストールする

共同作業で開発する場合や、(GitHub のような) オープンソース サイトでプロジェクトをホストする場合のために、VS Code では Git によるバージョン管理がサポートされています。 VS Code の [ソース管理] タブでは、すべての変更が追跡され、一般的な Git コマンド (追加、コミット、プッシュ、プル) が UI に組み込まれています。 ソース管理パネルを使用するには、まず Git をインストールする必要があります。

  1. Windows 用の Git を git-scm Web サイトからダウンロードしてインストールします。

  2. インストール ウィザードで、Git インストールの設定に関する一連の質問に答えます。 何かを変更する特別な理由がない限り、すべて既定の設定を使用することをお勧めします。

  3. 以前に Git を使用したことがない場合、入門用の GitHub ガイドが役に立ちます。

  4. Node プロジェクトに .gitignore ファイルを追加することをお勧めします。 GitHub の既定の Node.js 用 gitignore テンプレートは、こちらです。

Linux 用 Windows サブシステムを運用環境で使用する

Node.js を Windows で直接使用することは、何ができるかを学習し、体験するのに最適です。 通常は Linux ベースのサーバーに展開される運用環境対応の Web アプリを構築する準備ができたら、Linux 用 Windows サブシステムのバージョン 2 (WSL 2) を使用して Node.js Web アプリを開発することをお勧めします。 多くの Node.js パッケージおよびフレームワークは、*nix 環境を念頭に置いて作成され、ほとんどの Node.js アプリは Linux に展開されるため、WSL で開発すると、開発環境と運用環境の間で一貫性が確保されます。 WSL 開発環境を設定するには、「WSL 2 を使用して node.js 開発環境を設定する」を参照してください。

Note

Node.js アプリを Windows サーバーでホストする必要がある (まれな) 状況では、最も一般的なシナリオとして、リバース プロキシの使用が考えられます。 これを行うには、2 つの方法があります: iisnode を使うか、直接使用します。 Microsoft では、これらのリソースを保持していないので、Linux サーバーを使用して Node.js アプリをホストすることをお勧めします。