WSL2 Ubuntu 24.04 完全セットアップガイド — Node.js & Python 開発環境構築

約 10 分で読めます

WSL2 で Ubuntu 24.04 を使用した開発環境を構築しました。Node.js（pnpm 利用）と Python の両方に対応した実践的なセットアップ手順を紹介します。

セットアップの全体像

本記事で構築する環境：

  • Ubuntu 24.04 LTS（日本語環境）
  • Node.js 20.x（nvm 管理）
  • pnpm（パッケージマネージャー）
  • Python 3.12.7（pyenv 管理）
  • 開発ツール（Git、リンター、テストツール等）

1. システムの基本設定

パッケージの更新

sudo apt update && sudo apt upgrade -y

日本語環境とタイムゾーン

# 日本語言語パックのインストール
sudo apt install -y language-pack-ja

# ロケール設定
sudo update-locale LANG=ja_JP.UTF-8

# タイムゾーン設定
sudo timedatectl set-timezone Asia/Tokyo

2. 基本開発ツールのインストール

必須ツール群

sudo apt install -y \
  build-essential \
  git \
  curl \
  wget \
  vim \
  unzip

便利なコマンドラインツール

sudo apt install -y \
  tree \
  htop \
  jq \
  ncdu
ツール用途
treeディレクトリ構造の可視化
htopプロセス監視
jqJSON 処理
ncduディスク使用量分析

3. Git の初期設定

git config --global user.name "Your Name"
git config --global user.email "your@email.com"
git config --global core.quotepath false  # 日本語ファイル名対応

4. Node.js 環境の構築

nvm のインストール

# nvm インストール
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 設定読み込み
source ~/.bashrc

# バージョン確認
nvm --version

Node.js のインストール

# LTS 版のインストール
nvm install --lts

# Node.js 20 を指定インストール
nvm install 20

# デフォルトバージョンの設定
nvm alias default 20

# 確認
node -v   # v20.x.x
npm -v    # 10.x.x

pnpm のセットアップ

# グローバルインストール
npm install -g pnpm

# バージョン確認
pnpm -v

# シェル補完の設定
pnpm completion bash >> ~/.bashrc
source ~/.bashrc

pnpm の主な利点：

  • ディスク容量の節約（シンボリックリンク方式）
  • インストール速度の向上
  • 厳密な依存関係管理

5. Python 環境の構築

pyenv 用の依存パッケージ

sudo apt install -y \
  make \
  libssl-dev \
  zlib1g-dev \
  libbz2-dev \
  libreadline-dev \
  libsqlite3-dev \
  llvm \
  libncurses5-dev \
  libncursesw5-dev \
  xz-utils \
  tk-dev \
  libffi-dev \
  liblzma-dev \
  python3-openssl

pyenv のインストール

# pyenv インストール
curl https://pyenv.run | bash

# 環境変数の設定
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(pyenv init -)"' >> ~/.bashrc

# 設定読み込み
source ~/.bashrc

Python のインストール

# Python 3.12.7 のインストール
pyenv install 3.12.7

# グローバルデフォルトの設定
pyenv global 3.12.7

# 確認
python --version  # Python 3.12.7

# pip を最新版に更新
pip install --upgrade pip setuptools wheel

6. Python 開発ツールのセットアップ

# リンター・フォーマッター
pip install black flake8 pylint mypy

# テストツール
pip install pytest pytest-cov

# Jupyter（データ分析）
pip install jupyter notebook ipython

プロジェクトでの使い方

Node.js プロジェクト

mkdir my-node-project && cd my-node-project
pnpm init
pnpm add express
pnpm add -D typescript @types/node
pnpm run dev

Python プロジェクト

mkdir my-python-project && cd my-python-project
python -m venv .venv
source .venv/bin/activate

pip install requests pandas
black .
pytest

よくある問題と解決策

nvm コマンドが見つからない

source ~/.bashrc
# またはシェルの再起動
exec bash

pyenv での Python ビルドエラー

依存パッケージが不足している可能性があります。

sudo apt install -y build-essential libssl-dev zlib1g-dev

pnpm のパス問題

echo $PATH

# 必要に応じて .bashrc に追加
export PNPM_HOME="$HOME/.local/share/pnpm"
export PATH="$PNPM_HOME:$PATH"

ベストプラクティス

プロジェクトごとのバージョン管理

# Node.js プロジェクト
echo "20.17.0" > .nvmrc
nvm use  # .nvmrc のバージョンを自動適用

# Python プロジェクト
echo "3.12.7" > .python-version
# ディレクトリ移動時に自動切り替え

定期的なメンテナンス

# システムアップデート
sudo apt update && sudo apt upgrade -y

# Node.js パッケージの更新
pnpm update

# Python パッケージの確認
pip list --outdated

# 不要なキャッシュのクリア
pnpm store prune
pip cache purge

まとめ

WSL2 Ubuntu 24.04 で以下の環境を構築しました。

  • 基本システム設定 — 日本語環境とタイムゾーン設定、開発に必要な基本ツール
  • Node.js 環境 — nvm によるバージョン管理、pnpm による効率的なパッケージ管理
  • Python 環境 — pyenv によるバージョン管理、開発・テスト・データ分析ツール

この環境があれば、Web 開発からデータ分析まで幅広いプロジェクトに対応できます。プロジェクトごとにバージョンを切り替えながら、効率的な開発が可能です。

関連記事