開発環境構築完全ガイド

開発環境とは

「開発環境 (development environment)」とは、ソフトウェア開発に必要な OS / エディタ / 言語ランタイム / バージョン管理 / ビルドツール / DB / コンテナ / シェル設定を一式揃えたものを指します。本番環境 (production) / ステージング環境 (staging) と対比されるローカル PC 上の作業環境を指す場合と、これら 3 つを総称する場合があります。

環境の段階

1. OS の選択

2. エディタ / IDE

3. バージョン管理 (Git)

# Git インストール
sudo apt install -y git           # Linux/WSL
brew install git                  # Mac
choco install git                 # Windows (Chocolatey)

# 初期設定
git config --global user.name  "Your Name"
git config --global user.email "you@example.com"
git config --global init.defaultBranch main
git config --global pull.rebase true
git config --global core.editor "code --wait"

# 鍵生成
ssh-keygen -t ed25519 -C "you@example.com"
cat ~/.ssh/id_ed25519.pub          # GitHub Settings -> SSH Keys に登録

4. 言語ランタイムとバージョン管理

同じ PC で複数バージョン (例: Node 18 と 22) を切り替えたいので、各言語に専用のバージョンマネージャを入れます:

# asdf / mise (汎用バージョン管理)
brew install mise
mise install node@22
mise install python@3.12
mise install ruby@3.3
mise use --global node@22 python@3.12

# .tool-versions / .mise.toml をリポジトリに置けば自動切替
cat .tool-versions
# nodejs 22.5.1
# python 3.12.4

5. パッケージ管理

6. データベース

ローカルで DB を動かす方法は 3 通り:

• OS にネイティブインストール (brew install postgresql)
• Docker Compose で起動 (推奨)
• SQLite でファイル単体に閉じる (テスト/小規模)

# docker-compose.yml (Postgres + Redis + MySQL)
services:
  postgres:
    image: postgres:16-alpine
    environment:
      POSTGRES_PASSWORD: secret
    ports: ["5432:5432"]
    volumes: ["pgdata:/var/lib/postgresql/data"]

  mysql:
    image: mysql:8
    environment:
      MYSQL_ROOT_PASSWORD: secret
    ports: ["3306:3306"]

  redis:
    image: redis:7-alpine
    ports: ["6379:6379"]

volumes:
  pgdata:

7. Docker / コンテナ

近年は「自分のマシンに直接 PHP/Node/Postgres を入れずに Docker で固定」するスタイルが標準化しつつあります。利点:

• 環境差異が消える → 「私の PC では動く」が無くなる
• プロジェクト切替時に旧バージョンが残らない
• CI/CD でも同じ Dockerfile を使える

# 例: Laravel 開発環境
FROM php:8.3-fpm-alpine
RUN apk add --no-cache git unzip libpq-dev \
 && docker-php-ext-install pdo_pgsql opcache
COPY --from=composer:2 /usr/bin/composer /usr/bin/composer
WORKDIR /app

8. ターミナルとシェル

9. ドットファイル管理

.zshrc / .gitconfig / .vimrc / .tmux.conf を Git で管理し、新 PC でも 30 分で同じ環境が組めるようにします:

# 代表的ツール
brew install chezmoi    # 推奨
# or
yadm
# or
stow
# or 自作シンボリックリンクスクリプト

# 初期化
chezmoi init --apply git@github.com:you/dotfiles.git

10. SSH 鍵と認証

# 鍵生成 (ed25519 推奨)
ssh-keygen -t ed25519 -C "you@example.com"

# 公開鍵を GitHub / サーバに登録
cat ~/.ssh/id_ed25519.pub
ssh-copy-id user@server

# ~/.ssh/config で接続をまとめる
Host work
    HostName work.example.com
    User alice
    Port 22022
    IdentityFile ~/.ssh/id_work

Host github.com
    User git
    IdentityFile ~/.ssh/id_ed25519

11. シェル初期化スクリプトの構成例

# ~/.zshrc 抜粋
export EDITOR=nvim
export LANG=ja_JP.UTF-8

# starship
eval "$(starship init zsh)"

# mise (バージョン管理)
eval "$(mise activate zsh)"

# alias
alias g='git'
alias ll='eza -lah --git'
alias cat='bat -p'
alias k='kubectl'

# fzf
[ -f ~/.fzf.zsh ] && source ~/.fzf.zsh

12. 環境構築の自動化

新 PC を毎回ゼロから手作業で組むのは苦行なので、自動化が大事です:

• Brewfile: brew bundle dump でインストール済み一覧を保存 → brew bundle で再現
• Ansible playbook: 大規模な複数 PC 管理
• devcontainer.json: VS Code Remote Containers でリポジトリ毎に環境を共有
• Nix: 究極の再現性。学習コストは高い

FAQ

Q: Windows / Mac どちらが良い？
A: 業務指定がなければ Mac か Linux。会社支給が Windows なら WSL2 を入れれば Linux 系開発はほぼ可能。.NET / Visual Studio 主体なら Windows。

Q: バージョンマネージャを使う理由
A: プロジェクト A は Node 18、B は Node 22 のように並存と切替が必須だから。グローバル単一バージョンだと別案件で破綻します。

Q: 全部 Docker でやれば本当に楽？
A: 環境固定の利点は大きい一方、エディタ補完用にホストにも同じ言語を入れたい場面が出てきます。両立が現実解。