■ 方針

• 言語系（Perl/Python/Ruby/Node.jsなど）はanyenv + 各envでユーザー領域に導入。
• ツール群（neovim, git, etc）はHomebrew。
• C/C++開発ツール（make/clang等）はXcode Command Line Toolsで導入。
• sudo不要・/usr/local直書き回避・macOS標準を汚さない。

---

1. 事前準備

1-1. Xcode Command Line Toolsの導入

xcode-select --install

すでに入っていれば「already installed」と出るのでOK。

---

2. Homebrew 導入・初期設定

2-1. Homebrewのインストール

※公式 https://brew.sh/

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2-2. パスを通す（Apple Silicon）

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

---

3. anyenvで各種言語envの導入

3-1. anyenv本体

brew install anyenv
echo 'eval "$(anyenv init -)"' >> ~/.zshrc
exec $SHELL -l

3-2. 各種envの導入（必要に応じて）

anyenv install plenv      # Perl
anyenv install pyenv      # Python
anyenv install rbenv      # Ruby
anyenv install nodenv     # Node.js
anyenv install goenv      # Go など
exec $SHELL -l

ここから各言語のバージョン管理がすべてユーザー領域で可能に。

---

4. 各言語のセットアップ（例：Perl）

4-1. Perl（plenv）のセットアップ例

plenv install 5.42.0   # お好きなバージョン
plenv global 5.42.0

4-2. cpanmの導入（モジュール管理用）

plenv install-cpanm

plenv rehashも適宜。

---

5. Homebrewで開発ツール一括導入

brew install neovim git tmux fzf ripgrep fd bat tree gh

• 必要に応じてwget, zsh, lua, ghq, ctags, lazygitなども。

---

6. Python provider用（nvimでpython plugin使う場合）

pyenv install 3.12.3        # 最新推奨
pyenv global 3.12.3
pip install --user pynvim

---

7. Perl provider用（nvimでperl plugin使う場合）

7-1. 必要なcpanmモジュールインストール

cpanm --local-lib=~/perl5 Neovim::Ext

失敗したら--notestや--forceを追加。 export PERL5LIB="$HOME/perl5/lib/perl5:$PERL5LIB" も .zshrc に追記。

---

8. Node.js provider用（nvimでnode plugin使う場合）

nodenv install 20.14.0      # 任意のバージョン
nodenv global 20.14.0
npm install -g neovim

---

9. ~/.zshrc 設定例（anyenv/brew/各provider連携）

# anyenv
eval "$(anyenv init -)"

# Homebrew (Apple Silicon)
eval "$(/opt/homebrew/bin/brew shellenv)"

# Perl provider
export PERL5LIB="$HOME/perl5/lib/perl5:$PERL5LIB"
export PATH="$HOME/perl5/bin:$PATH"

# Python provider (pyenvのsite-packagesが--userになっていれば不要)
# export PATH="$HOME/.local/bin:$PATH"

# Node provider
# (npm globalのパスがnodenvで正しく通っていれば不要)

# その他（必要に応じて）

---

10. nvim provider確認 & 動作確認

nvim内で

:checkhealth

で各provider（Python, Perl, Nodeなど）がOK表示になることを確認！

---

11. よくあるトラブル時のヒント

• makeやccが無い→Xcode Command Line Tools不足を再確認
• providerがnot found→パスや環境変数、provider用モジュール再インストール
• Perl providerのみテスト一部失敗→--notestでcpanm再実行、実害なし

---

まとめ

• anyenv + Homebrewで言語もツールもユーザ空間管理
• M1ネイティブ環境を活かしつつ標準環境を汚さない構成
• どのproviderも必要になった時だけ最小セットアップでOK

---

追加のワンポイント

• 「brew upgrade」や「anyenv upgrade」などは定期的に。
• Zshの設定（.zshrc）は冗長にならないよう都度整理すること。
• nvimのconfig（~/.config/nvim/init.lua or init.vim）も適宜管理しておく。

---

「何度でもやり直せて・壊しやすく・クリーンな環境を維持できる」運用が最大の強みです。

困ったら :checkhealth・brew doctor・anyenv versions を最初にチェック！

---