LinuxにNode.jsをインストールして使う入門｜nvmでWSL2やVPSにJavaScript実行環境を構築する方法

この記事のポイント

・Linux（Ubuntu/Rocky Linux）へnvmでNode.jsをインストールできる
・npmコマンドでパッケージを管理する基本操作を習得できる
・node コマンドでJSファイルを実行・動作確認する方法がわかる
・よくあるエラーと対処法も網羅している

# ログインユーザーを確認する
$ whoami
tomohiro

# OSの種類を確認する（Ubuntu/Rocky Linuxなど）
$ cat /etc/os-release | head -4
NAME="Ubuntu"
VERSION="24.04.2 LTS (Noble Numbat)"
ID=ubuntu
ID_LIKE=debian

# Ubuntuかどうか確認する
$ which apt
/usr/bin/apt

# Rocky Linuxかどうか確認する
$ which dnf
/usr/bin/dnf

# curlでnvmのインストールスクリプトをダウンロード・実行する
$ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash

# 実行後の出力例
=> Downloading nvm from git to '/home/tomohiro/.nvm'
=> Cloning into '/home/tomohiro/.nvm'...
remote: Enumerating objects: 375, done.
remote: Counting objects: 100% (375/375), done.
=> Appending nvm source string to /home/tomohiro/.bashrc
=> Appending bash_completion source string to /home/tomohiro/.bashrc
=> Close and reopen your terminal to start using nvm or run the following to use it now:

# .bashrcを再読み込みする
$ source ~/.bashrc

# nvmが使えるようになったか確認する
$ nvm --version
0.40.0

# Ubuntu/Debianの場合
$ sudo apt update && sudo apt install -y curl

# Rocky Linux/RHELの場合
$ sudo dnf install -y curl

# 最新LTS版のNode.jsをインストールする
$ nvm install --lts

# インストール後の出力例
Installing latest LTS version.
Downloading and installing node v20.18.0...
Downloading https://nodejs.org/dist/v20.18.0/node-v20.18.0-linux-x64.tar.xz...
#########################################################  100.0%
Computing checksum with sha256sum
Checksums matched!
Now using node v20.18.0 (npm v10.8.2)
Creating default alias: default -> lts/* (-> v20.18.0)

# Node.jsのバージョンを確認する
$ node --version
v20.18.0

# npm（パッケージマネージャー）のバージョンも確認する
$ npm --version
10.8.2

# インストール済みのNode.jsバージョン一覧を表示する
$ nvm ls
->     v20.18.0
default -> lts/* (-> v20.18.0)

# プロジェクト用ディレクトリを作成して移動する
$ mkdir my-node-project && cd my-node-project

# package.jsonを生成する（-yで質問をスキップ）
$ npm init -y

# 出力例
Wrote to /home/tomohiro/my-node-project/package.json:
{
  "name": "my-node-project",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo "Error: no test specified" && exit 1"
  },
  "author": "",
  "license": "ISC"
}

# lodash（ユーティリティライブラリ）をインストールする例
$ npm install lodash

# 出力例
added 1 package, and audited 2 packages in 2s
1 package is looking for funding
  run `npm fund` for details
found 0 vulnerabilities

# インストール済みパッケージの一覧を確認する
$ npm list
my-node-project@1.0.0 /home/tomohiro/my-node-project
└── lodash@4.17.21

# パッケージを削除する
$ npm uninstall lodash

removed 1 package, and audited 1 package in 1s
found 0 vulnerabilities

# テキストエディタ（nano）でJSファイルを作成する
$ nano hello.js

// hello.js
console.log('Hello, Linux Node.js!');

const now = new Date();
console.log('現在時刻: ' + now.toLocaleString('ja-JP'));

# nodeコマンドでJSファイルを実行する
$ node hello.js

# 出力例
Hello, Linux Node.js!
現在時刻: 2026/6/4 10:00:00

# REPLを起動する
$ node
Welcome to Node.js v20.18.0.
Type ".help" for more information.
> 1 + 2
3
> console.log('test')
test
undefined
> .exit
$

# Node.js 18系をインストールする
$ nvm install 18

# インストール済みバージョン一覧を確認する
$ nvm ls
       v18.20.5
->     v20.18.0
default -> lts/* (-> v20.18.0)
lts/* -> lts/iron (-> v20.18.0)
lts/hydrogen -> v18.20.5

# Node.js 18に切り替える
$ nvm use 18
Now using node v18.20.5 (npm v10.7.0)

# バージョンを確認する
$ node --version
v18.20.5

# 元のLTS（v20）に戻す
$ nvm use --lts
Now using node v20.18.0 (npm v10.8.2)

# .nvmrcファイルを作成する（v20を指定する例）
$ echo "20" > .nvmrc

# .nvmrcを読んでバージョンを切り替える
$ nvm use
Found '/home/tomohiro/my-node-project/.nvmrc' with version <20>
Now using node v20.18.0 (npm v10.8.2)

# .bashrcを再読み込みする
$ source ~/.bashrc

# または新しいターミナルを開き直す
# WSL2の場合はウィンドウを閉じて再度開く

# ~/.bashrc にnvmの記述があるか確認する
$ grep -n "nvm" ~/.bashrc
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm

# 手動でnvmのパス設定を~/.bashrcに追記する
$ echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.bashrc
$ echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.bashrc
$ source ~/.bashrc

# インストール済みバージョンを確認する
$ nvm ls

# 何も表示されない場合はLTS版をインストールする
$ nvm install --lts

# バージョンが表示されるがnodeが使えない場合はuse で切り替える
$ nvm use --lts

# エラーの例
$ npm install -g some-package
npm WARN checkPermissions Missing write access to /usr/lib/node_modules
npm ERR! code EACCES
npm ERR! syscall access
npm ERR! path /usr/lib/node_modules

# 対処：nvmでNode.jsをインストールし直す
# （nvmを使えばsudo不要でグローバルインストールが可能になる）
$ nvm install --lts
$ nvm use --lts
$ npm install -g some-package   # sudoなしで成功する

# エラーの例
npm WARN EBADENGINE Unsupported engine {
npm WARN EBADENGINE   package: 'some-package@2.0.0',
npm WARN EBADENGINE   required: { node: '>=20' },
npm WARN EBADENGINE   current: { node: 'v18.20.5', npm: '10.7.0' }
npm WARN EBADENGINE }

# 対処：Node.jsを必要バージョン以上に切り替える
$ nvm use 20
$ npm install some-package