# Mac開発マシン初期設定完全ガイド
Macで開発を行う際に必要なパッケージと初期設定を一括で行う方法を解説します。Homebrewを使った効率的な環境構築手順をまとめました。
# Homebrewのインストール
Homebrewは、macOS用のパッケージマネージャーです。開発に必要なツールを簡単にインストールできます。
# Homebrewのインストール
ターミナルで以下のコマンドを実行します。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
# 権限設定
インストール後、以下のコマンドで権限を設定します。
sudo chown -R $(whoami):admin /usr/local/*
sudo chmod -R g+w /usr/local/*
注意
権限設定は、Homebrewが正常に動作するために必要な場合があります。エラーが発生した場合のみ実行してください。
# brewコマンドで必要なパッケージを個別インストール
以下のコマンドで、必要なパッケージを個別にインストールできます。
# データベース
brew install mysql
# Webサーバー
brew install httpd
# バージョン管理
brew install git
# Node.jsバージョン管理
brew install nodebrew
# コマンドラインツール
brew install bat # catの代替コマンド
brew install fd # findの代替コマンド
# 開発ツール（Cask）
brew install --cask visual-studio-code # エディタ
brew install --cask docker # コンテナ環境
# ユーティリティ（Cask）
brew install --cask spectacle # 画面リサイズツール
brew install --cask clipy # クリップボード管理
# ブラウザ（Cask）
brew install --cask google-chrome
brew install --cask firefox
# クラウドストレージ（Cask）
brew install --cask onedrive
brew install --cask google-drive
Caskとは
--caskオプションは、GUIアプリケーションをインストールする際に使用します。コマンドラインツールの場合はbrew installのみでOKです。
# Brewfileで一括インストール（推奨）
個別にインストールするよりも、Brewfileを作成して一括インストールする方が効率的です。
# Brewfileの作成
拡張子なしのBrewfileファイルを作成し、以下の内容を記述します。
tap "homebrew/bundle"
tap "homebrew/cask"
tap "homebrew/cask-versions"
tap "homebrew/core"
tap "homebrew/services"
# コマンドラインツール
brew "bat"
brew "composer"
brew "fd"
brew "git"
brew "mysql"
brew "httpd"
brew "nodebrew"
brew "php@8.4", restart_service: true, link: true
# GUIアプリケーション（Cask）
cask "clipy"
cask "docker"
cask "firefox"
cask "google-chrome"
cask "google-drive"
cask "onedrive"
cask "spectacle"
cask "visual-studio-code"
# 一括インストールの実行
ファイルを作成したら、以下のコマンドで一括インストールします。
brew bundle
# 既存のインストールからBrewfileを生成
すでにインストールしたパッケージからBrewfileを生成する場合は、以下のコマンドを実行します。
# Brewfileを生成
brew bundle dump
生成されたBrewfileを編集して、必要なパッケージのみに絞り込むことができます。
Brewfileのメリット
- 環境を再現しやすい
- バージョン管理できる（Gitで管理可能）
- 新しいMacでも同じ環境を構築できる
# NodebrewでNode.jsをバージョン管理
Nodebrewは、Node.jsをバージョン別に管理・インストールできるツールです。
# Nodebrewのセットアップ
nodebrew setup
# Node.jsのインストール
# 最新の安定版をインストール
nodebrew install-binary stable
nodebrew use stable
# 特定のバージョンをインストール
nodebrew install-binary v22
nodebrew install-binary v24
# 使用するバージョンを切り替え
nodebrew use v12
バージョン切り替え
nodebrew use <バージョン>で、使用するNode.jsのバージョンを切り替えられます。プロジェクトごとに異なるバージョンが必要な場合に便利です。
# SSH公開鍵の生成と設定
SSH接続を行うために、公開鍵を生成して設定します。
# SSH鍵の生成
# .sshディレクトリの作成
mkdir ~/.ssh
chmod 700 ~/.ssh
# 公開鍵・秘密鍵の生成
ssh-keygen -t rsa
# 公開鍵の表示（GitHubなどに登録する際に使用）
cat ~/.ssh/id_rsa.pub
# SSH設定ファイルの作成
複数のサーバーに接続する場合、~/.ssh/configファイルを作成して設定を管理できます。
# 鍵ファイル用のディレクトリ作成
mkdir ~/.ssh/key
chmod 700 ~/.ssh/key
# 既存の鍵ファイルがある場合、権限を設定
chmod 400 ~/.ssh/key/*
# 設定ファイルを編集
vi ~/.ssh/config
# ~/.ssh/configの設定例
Host testssh
HostName sv12345.xserver.jp
User xs12345
IdentityFile ~/.ssh/key/xs12345.key
Port 22
設定ファイルの権限を設定します。
chmod 600 ~/.ssh/config
セキュリティ
SSH鍵ファイルと設定ファイルの権限は適切に設定する必要があります。権限が緩いと、セキュリティリスクになります。
# システム環境設定
開発環境を快適にするために、以下のシステム設定を推奨します。
| 設定項目 | 内容 |
|---|---|
| トラックパッド | 右クリックを有効化 |
| ディスプレイ | ダークモードに設定（目に優しい） |
| Launchpad | アプリケーションを整理 |
| Dock | 大きさを調整 |
| キーボード | F1、F2キーを表示（機能キーとして使用） |
ダークモード
長時間の開発作業では、ダークモードが目に優しく、疲労を軽減できます。
# 隠しファイルの表示設定
開発作業では、隠しファイル（ドットファイル）を表示することがあります。
# 隠しファイルを表示
defaults write com.apple.finder AppleShowAllFiles -boolean true
killall Finder
# 隠しファイルを非表示
defaults delete com.apple.finder AppleShowAllFiles
killall Finder
Finderの再起動
設定を反映させるために、killall FinderでFinderを再起動します。
# Gitの設定
# Git設定の確認
現在の設定を確認するには、以下のコマンドを実行します。
# ローカルの設定を確認
git config -l
# グローバルの設定を確認
git config --global -l
# ユーザー名とメールアドレスの設定
Gitでコミットする際に使用する、ユーザー名とメールアドレスを設定します。
git config --global user.name "ユーザー名"
git config --global user.email "email@example.com"
重要
GitHubなどにコミットする際は、登録しているメールアドレスと一致させる必要があります。
# Gitカラー設定
Gitの出力をカラー表示にする設定です。
git config --global color.ui true
git config --global color.diff auto
git config --global color.status auto
git config --global color.branch auto
カラー表示により、変更内容が視覚的に分かりやすくなります。
# Git Bash for Mac（オプション）
Macのbashターミナルはシンプルですが、色が鮮やかなGit Bashが使いやすいので、Git Bash for Mac (opens new window)をインストールすることもできます。
# インストール
ターミナルから以下のコマンドを実行します。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/fabriziocucci/git-bash-for-mac/master/install.sh)"
# 設定
- ターミナルの設定から「プロファイル」を選択
- テーマを
Proに変更 - ターミナルを再起動
# アンインストール
不要になった場合は、以下のコマンドでアンインストールできます。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/fabriziocucci/git-bash-for-mac/master/uninstall.sh)"
オプション
Git Bash for Macは必須ではありません。標準のターミナルでも問題なく開発できます。
# 実装時の注意点
Mac開発環境の初期設定は、以下の手順で完了する。
- Homebrewのインストール
- 必要なパッケージのインストール（Brewfile推奨）
- Nodebrewのセットアップ（Node.jsが必要な場合）
- SSH鍵の生成と設定
- Gitの設定
- システム環境設定
これらの設定により、効率的な開発環境が構築できる。BrewfileをGitで管理しておけば、新しいMacでも同じ環境を簡単に再現できる。