このドキュメントは、MacBook（MacBook Air / Pro）で
安全かつ標準的な開発環境を構築する手順をまとめたものです。
対象：
- Mac 開発初心者
- 初めてターミナルを使う人
- 環境をきれいに管理したい人
1. macOS の基本ディレクトリ構成
macOS は Unix ベースの OS です。
ルート構造：
/
├── System # macOS本体（触らない）
├── usr # システムコマンド
├── bin # 基本コマンド
├── Applications # アプリ
└── Users # ユーザー領域（ここを使う）
⚠️ 開発は必ず Users 配下で行う
自分の作業場所（ホームディレクトリ）
/Users/ユーザー名
# ショートカット：
cd ~
推奨ディレクトリ構成（重要）
開発者の定番構成：
~
├── dev
│ ├── projects # 本番プロジェクト
│ └── sandbox # 実験・学習
├── .config # 各種設定
└── bin # 自作コマンド
作成：
mkdir -p ~/dev/{projects}
mkdir ~/.config
mkdir ~/bin
ディレクトリの役割
~/dev/projects
Git 管理する開発用コード
継続プロジェクト
例：
projects/
├── api-server
├── portfolio
└── study-app
~/dev/sandbox
学習・検証用
壊してOK
2. パッケージマネージャ（Homebrew）
Macでは Homebrew が事実上の標準。
役割：
- ソフトのインストール管理
- 依存関係の解決
- アンインストール管理
- インストール
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew command not found の解決
以下のエラーが出る場合：
zsh: command not found: brew
原因：
- PATH が設定されていない
- PATH を設定
- Apple Silicon Mac の場合：
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
確認
brew --version
成功例：
Homebrew 4.x.x
動作チェック
brew doctor
表示：
Your system is ready to brew.
最初に入れる基本ツール
brew update
brew upgrade
brew install git
Homebrew のインストール場所（知識）
Apple Silicon Mac：
/opt/homebrew
⚠️ 手動で編集しない。
3. ターミナル（おすすめ）
macOS標準 Terminal でもOKだが、
開発では以下がおすすめ：
iTerm2（高機能ターミナル）
インストール：
brew install --cask iterm2
4. 推奨開発環境（基本セット）
| 役割 | ツール |
|---|---|
| パッケージ管理 | Homebrew |
| ターミナル | iTerm2 |
| シェル | zsh |
| エディタ | VS Code |
VS Code：
brew install --cask visual-studio-code
終わりに
✅ 完了チェックリスト
- brew --version が動く
- brew doctor OK
- ~/dev 作成済み
- git インストール済み
- VS Code インストール済み
🎯 次にやると良いこと
- zsh カスタマイズ
- dotfiles 管理
- Git 初期設定