# ─── インストール ───
# macOS
brew install fnm
# Linux/macOS (curl)
curl -fsSL https://fnm.vercel.app/install | bash
# Windows
winget install Schniz.fnm
# Cargo (Rust 環境がある場合)
cargo install fnm
 
# ─── シェル設定 ───
# ~/.zshrc に追加
eval "$(fnm env --use-on-cd --shell zsh)"
# ~/.bashrc に追加
eval "$(fnm env --use-on-cd --shell bash)"
# ~/.config/fish/config.fish に追加
fnm env --use-on-cd --shell fish | source
# PowerShell ($PROFILE に追加)
fnm env --use-on-cd --shell powershell | Out-String | Invoke-Expression
 
# ─── 基本操作 ───
fnm list-remote              # 利用可能なバージョン一覧
fnm install 20               # Node.js 20.x 最新をインストール
fnm install 22               # Node.js 22.x 最新をインストール
fnm install --lts            # 最新 LTS をインストール
fnm use 20                   # 現在のシェルで切替
fnm default 20               # デフォルトバージョン設定
fnm list                     # インストール済み一覧
fnm current                  # 現在のバージョン確認
fnm uninstall 18             # 不要バージョン削除
 
# ─── プロジェクト設定 ───
echo "20" > .node-version    # プロジェクトルートに配置
# → cd でディレクトリに入ると自動切替 (--use-on-cd)
 
# ─── 特定のマイナー/パッチバージョンを指定 ───
echo "20.11.0" > .node-version
fnm install                  # .node-version に記載されたバージョンをインストール
fnm use                      # .node-version に記載されたバージョンに切替

# ─── fnm 環境変数によるカスタマイズ ───
# ~/.zshrc に追加
 
# インストールディレクトリの変更
export FNM_DIR="$HOME/.fnm"
 
# Corepack を自動有効化
export FNM_COREPACK_ENABLED="true"
 
# バージョン解決方式（.node-version を上位ディレクトリも探索）
export FNM_RESOLVE_ENGINES="true"
 
# ログレベル設定
export FNM_LOGLEVEL="info"  # quiet, info, all, error
 
# 全オプションを含む完全な設定
eval "$(fnm env --use-on-cd --version-file-strategy=recursive --corepack-enabled --shell zsh)"
 
# ─── バージョンファイル戦略 ───
# recursive: カレントから上位ディレクトリを再帰的に探索
# local: カレントディレクトリのみ
eval "$(fnm env --use-on-cd --version-file-strategy=recursive --shell zsh)"
 
# ─── fnm completions ───
# zsh 補完の有効化
fnm completions --shell zsh > "${fpath[1]}/_fnm"
# bash 補完
fnm completions --shell bash > /etc/bash_completion.d/fnm
 
# ─── エイリアス管理 ───
fnm alias 20.11.0 lts-iron   # カスタムエイリアス作成
fnm alias 22.0.0 latest      # 最新版にエイリアス
fnm alias list                # エイリアス一覧
fnm default lts-iron          # エイリアスをデフォルトに設定

# ─── インストール ───
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
 
# ─── ~/.zshrc に自動追加される設定 ───
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
 
# ─── 基本操作 ───
nvm install 20               # インストール
nvm install --lts            # 最新 LTS
nvm use 20                   # 切替
nvm alias default 20         # デフォルト設定
nvm ls                       # インストール済み一覧
nvm ls-remote --lts          # リモートの LTS 一覧
nvm uninstall 18             # 不要バージョン削除
 
# ─── .nvmrc ───
echo "20" > .nvmrc
nvm use                      # .nvmrc のバージョンを使用
 
# ─── 自動切替スクリプト (~/.zshrc に追加) ───
autoload -U add-zsh-hook
load-nvmrc() {
  local nvmrc_path="$(nvm_find_nvmrc)"
  if [ -n "$nvmrc_path" ]; then
    local nvmrc_node_version=$(nvm version "$(cat "${nvmrc_path}")")
    if [ "$nvmrc_node_version" = "N/A" ]; then
      nvm install
    elif [ "$nvmrc_node_version" != "$(nvm version)" ]; then
      nvm use
    fi
  fi
}
add-zsh-hook chpwd load-nvmrc
load-nvmrc

# nvm のシェル起動時間を改善する遅延ロード設定
# ~/.zshrc に追加（nvm 標準設定の代わりに使用）
 
export NVM_DIR="$HOME/.nvm"
 
# nvm を遅延ロードする関数群
lazy_load_nvm() {
  unset -f nvm node npm npx yarn pnpm corepack
  [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
  [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
}
 
# コマンド初回呼び出し時にロード
nvm() { lazy_load_nvm; nvm "$@"; }
node() { lazy_load_nvm; node "$@"; }
npm() { lazy_load_nvm; npm "$@"; }
npx() { lazy_load_nvm; npx "$@"; }
yarn() { lazy_load_nvm; yarn "$@"; }
pnpm() { lazy_load_nvm; pnpm "$@"; }
corepack() { lazy_load_nvm; corepack "$@"; }
 
# 効果:
# - シェル起動時間: 500ms → 50ms（nvm 本体のロードを遅延）
# - 初回 node コマンド実行時に一度だけロード
# - デメリット: 初回コマンドが少し遅い（500ms 程度の追加遅延）

# nvm でグローバルインストールしたパッケージを新バージョンに引き継ぐ
nvm install 22 --reinstall-packages-from=20
 
# nvm から fnm への移行手順
# 1. 現在のバージョンを確認
nvm ls
#   v18.19.1
#   v20.11.0
# → default -> 20
 
# 2. fnm をインストール
brew install fnm
 
# 3. シェル設定を置き換え
# ~/.zshrc から nvm 関連行を削除し、以下を追加:
eval "$(fnm env --use-on-cd --shell zsh)"
 
# 4. 同じバージョンをインストール
fnm install 18
fnm install 20
fnm default 20
 
# 5. .nvmrc はそのまま使える（fnm は .nvmrc を読める）
 
# 6. nvm を削除
rm -rf ~/.nvm
# ~/.zshrc から NVM_DIR 関連の行を削除

# ─── インストール ───
# macOS / Linux
curl https://get.volta.sh | bash
# Windows
# https://github.com/volta-cli/volta/releases から .msi をダウンロード
 
# ─── 基本操作 ───
volta install node@20        # Node.js インストール
volta install node@latest    # 最新版インストール
volta install npm@10         # npm バージョン固定
volta install yarn@4         # yarn バージョン固定
volta install pnpm@9         # pnpm バージョン固定
 
# ─── プロジェクト固定 (package.json に記録) ───
volta pin node@20
volta pin npm@10
volta pin yarn@4
 
# package.json に自動追記される:
# {
#   "volta": {
#     "node": "20.11.0",
#     "npm": "10.2.4",
#     "yarn": "4.1.0"
#   }
# }
 
# ─── グローバルツールのインストール ───
volta install typescript      # tsc コマンドをグローバルに利用可能
volta install @angular/cli    # ng コマンドをグローバルに利用可能
volta install create-react-app
 
# ─── 情報確認 ───
volta list                   # インストール済みツール一覧
volta list all               # 全バージョン一覧
volta which node             # 現在のプロジェクトで使われる node のパス

# ─── Volta のプロジェクト自動検出 ───
# package.json の volta フィールドがあるディレクトリに入ると
# 自動的にそのバージョンの Node.js が使われる
 
# プロジェクトA (Node 18)
$ cd ~/projects/legacy-app
$ node --version
v18.19.1
 
# プロジェクトB (Node 22)
$ cd ~/projects/new-app
$ node --version
v22.0.0
 
# シェルフック不要 — Volta の node バイナリ自体がプロキシ
 
# ─── Volta のツールチェーン管理 ───
# Volta はパッケージマネージャーのバージョンも固定できる
volta pin node@20.11.0
volta pin npm@10.2.4
volta pin yarn@4.1.0
 
# チームメンバーが Volta を使っていれば、
# clone 後すぐに同じバージョンで開発可能
 
# ─── package.json の engines との連携 ───
# Volta は engines フィールドも参考にするが、
# volta フィールドが優先される
{
  "engines": {
    "node": ">=20.0.0"
  },
  "volta": {
    "node": "20.11.0"
  }
}
 
# ─── Volta のフック ───
# ~/.volta/hooks.json で追加設定が可能
{
  "node": {
    "index": {
      "prefix": "https://your-mirror.example.com/node/"
    }
  }
}

# ─── インストール ───
# macOS
brew install pyenv pyenv-virtualenv
 
# Linux (Ubuntu/Debian)
curl https://pyenv.run | bash
 
# Linux (依存パッケージのインストールが必要)
sudo apt-get update && sudo apt-get install -y \
  make build-essential libssl-dev zlib1g-dev \
  libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm \
  libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev \
  libffi-dev liblzma-dev
 
# ─── シェル設定 (~/.zshrc) ───
export PYENV_ROOT="$HOME/.pyenv"
[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"
eval "$(pyenv virtualenv-init -)"
 
# ─── bash の場合 (~/.bashrc) ───
export PYENV_ROOT="$HOME/.pyenv"
command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"
eval "$(pyenv virtualenv-init -)"
 
# ─── ビルド依存のインストール (macOS) ───
brew install openssl readline sqlite3 xz zlib tcl-tk
 
# ─── 基本操作 ───
pyenv install --list | grep '3.12'   # 利用可能バージョン
pyenv install --list | grep '3.13'   # 最新バージョンの確認
pyenv install 3.12.3                  # インストール
pyenv global 3.12.3                   # グローバルデフォルト
pyenv local 3.12.3                    # プロジェクト固定 (.python-version)
pyenv versions                        # インストール済み一覧
pyenv version                         # 現在のバージョン
pyenv uninstall 3.11.0                # 不要バージョン削除
 
# ─── 仮想環境 ───
pyenv virtualenv 3.12.3 myproject-env
pyenv activate myproject-env
pyenv deactivate

# ─── macOS でよくあるビルドエラーと解決策 ───
 
# エラー: "zlib not available"
CFLAGS="-I$(brew --prefix zlib)/include" \
LDFLAGS="-L$(brew --prefix zlib)/lib" \
pyenv install 3.12.3
 
# エラー: "openssl not found"
CONFIGURE_OPTS="--with-openssl=$(brew --prefix openssl@3)" \
pyenv install 3.12.3
 
# macOS Sonoma 以降の包括的な環境変数設定
export LDFLAGS="-L$(brew --prefix openssl@3)/lib -L$(brew --prefix readline)/lib -L$(brew --prefix zlib)/lib"
export CPPFLAGS="-I$(brew --prefix openssl@3)/include -I$(brew --prefix readline)/include -I$(brew --prefix zlib)/include"
export PKG_CONFIG_PATH="$(brew --prefix openssl@3)/lib/pkgconfig:$(brew --prefix readline)/lib/pkgconfig:$(brew --prefix zlib)/lib/pkgconfig"
pyenv install 3.12.3
 
# ─── Linux でよくあるビルドエラー ───
 
# エラー: "No module named '_ctypes'"
sudo apt-get install libffi-dev
pyenv install 3.12.3
 
# エラー: "ModuleNotFoundError: No module named '_lzma'"
sudo apt-get install liblzma-dev
pyenv install 3.12.3
 
# エラー: "WARNING: The Python tkinter extension was not compiled"
sudo apt-get install tk-dev
pyenv install 3.12.3
 
# ─── 最適化ビルド ───
# PROFILE_TASK を使ってプロファイルガイド最適化 (PGO) を有効化
PYTHON_CONFIGURE_OPTS="--enable-optimizations --with-lto" \
PYTHON_CFLAGS="-march=native -mtune=native" \
pyenv install 3.12.3
 
# ─── デバッグビルド ───
# メモリリークやセグフォルトの調査用
pyenv install --debug 3.12.3

# ─── 仮想環境の作成と管理 ───
pyenv virtualenv 3.12.3 myproject-3.12    # バージョン名付き仮想環境
pyenv virtualenvs                          # 仮想環境の一覧
pyenv virtualenv-delete myproject-3.12     # 仮想環境の削除
 
# ─── プロジェクトごとの自動有効化 ───
cd ~/projects/myproject
pyenv local myproject-3.12
# → .python-version に "myproject-3.12" が書かれる
# → 以降このディレクトリに入ると自動で仮想環境が有効になる
 
# ─── 複数 Python バージョンでのテスト ───
# tox や nox と組み合わせて複数バージョンテスト
pyenv install 3.11.8
pyenv install 3.12.3
pyenv install 3.13.0
pyenv local 3.12.3 3.11.8 3.13.0  # 複数バージョンを設定
 
# tox.ini
# [tox]
# envlist = py311, py312, py313
# [testenv]
# commands = pytest
 
# ─── pyenv と uv の併用 ───
# pyenv で Python バージョンを管理し、uv でパッケージを管理
pyenv local 3.12.3
uv venv                      # pyenv の Python を使って仮想環境作成
uv pip install -r requirements.txt

# uv は pyenv の代替としても使える（2025年以降の推奨）
# Python 自体のインストール・管理が可能
 
# ─── Python のインストール ───
uv python install 3.12       # Python 3.12 をインストール
uv python install 3.11 3.12 3.13  # 複数バージョンを一括インストール
uv python list                # 利用可能バージョン一覧
uv python find 3.12           # インストール済み 3.12 のパスを表示
 
# ─── プロジェクト固定 ───
uv python pin 3.12            # .python-version を生成
 
# ─── pyenv との違い ───
# pyenv: ソースからビルド（ビルド依存が必要・時間がかかる）
# uv:    プリビルドバイナリをダウンロード（数秒で完了）
#        → python-build-standalone プロジェクトのバイナリを使用
 
# ─── uv で Python + パッケージを統合管理 ───
uv init my-project            # プロジェクト初期化
cd my-project
uv python pin 3.12            # Python バージョン固定
uv add requests flask         # パッケージ追加
uv run python main.py         # 仮想環境内で実行

# ─── インストール ───
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
 
# インストール時のオプション選択
# 1) Proceed with standard installation (default)
# 2) Customize installation
# 3) Cancel installation
# → 通常は 1 を選択
 
# ─── シェル設定（自動で追加されるが確認） ───
# ~/.zshrc または ~/.bashrc
source "$HOME/.cargo/env"
 
# ─── 基本操作 ───
rustup show                          # 現在の toolchain
rustup update                        # 全 toolchain 更新
rustup default stable                # デフォルト設定
rustup default nightly               # nightly をデフォルトに
rustup toolchain install nightly     # nightly インストール
rustup toolchain install 1.77.0     # 特定バージョンをインストール
rustup toolchain list                # インストール済み toolchain 一覧
rustup toolchain uninstall nightly   # 不要 toolchain 削除
 
# ─── プロジェクト固定 ───
# rust-toolchain.toml (プロジェクトルート)
cat << 'EOF' > rust-toolchain.toml
[toolchain]
channel = "1.77.0"
components = ["rustfmt", "clippy"]
targets = ["wasm32-unknown-unknown"]
EOF
 
# ─── コンポーネント管理 ───
rustup component add rustfmt         # フォーマッタ
rustup component add clippy          # リンター
rustup component add rust-analyzer   # LSP
rustup component add rust-src        # ソースコード（IDE 補完用）
rustup component add llvm-tools      # LLVM ツール（カバレッジ等）
rustup component add miri            # 未定義動作検出ツール（nightly のみ）
rustup component list                # 利用可能コンポーネント一覧

# ─── クロスコンパイル ───
# ターゲットプラットフォームの追加
rustup target add x86_64-unknown-linux-musl     # 静的リンク Linux
rustup target add aarch64-unknown-linux-gnu     # ARM64 Linux
rustup target add wasm32-unknown-unknown        # WebAssembly
rustup target add aarch64-apple-darwin          # Apple Silicon
rustup target add x86_64-pc-windows-msvc        # Windows
 
# クロスコンパイルの実行
cargo build --target x86_64-unknown-linux-musl
 
# ─── nightly 機能の利用 ───
# 特定のファイルだけ nightly を使う
rustup run nightly cargo build
rustup run nightly cargo +nightly fmt
 
# nightly のみの機能をプロジェクトで使う
cat << 'EOF' > rust-toolchain.toml
[toolchain]
channel = "nightly-2024-03-15"
components = ["rustfmt", "clippy", "miri", "rust-src"]
EOF
 
# ─── rustup のプロキシ設定 ───
# 企業プロキシ環境での設定
export RUSTUP_DIST_SERVER="https://your-mirror.example.com/rustup"
export RUSTUP_UPDATE_ROOT="https://your-mirror.example.com/rustup/rustup"
 
# ─── rustup self コマンド ───
rustup self update              # rustup 自体を更新
rustup self uninstall           # rustup と全 toolchain を削除
 
# ─── オーバーライド ───
# 特定ディレクトリで異なる toolchain を使用
rustup override set nightly     # カレントディレクトリ用
rustup override list            # オーバーライド一覧
rustup override unset           # オーバーライド解除

# rust-toolchain.toml - プロジェクトルートに配置
 
[toolchain]
# チャンネル指定（以下のいずれか）
channel = "1.77.0"          # 特定バージョン
# channel = "stable"        # 最新安定版（推奨しない: 再現性が低い）
# channel = "nightly"       # 最新 nightly
# channel = "nightly-2024-03-15"  # 日付指定 nightly
 
# 必要なコンポーネント
components = [
  "rustfmt",        # コードフォーマッタ
  "clippy",         # リンター
  "rust-analyzer",  # LSP サーバー
  "rust-src",       # ソースコード（IDE 補完に必要）
]
 
# クロスコンパイルターゲット
targets = [
  "x86_64-unknown-linux-musl",
  "wasm32-unknown-unknown",
  "aarch64-apple-darwin",
]
 
# プロファイル（minimal, default, complete）
profile = "default"

# ─── インストール ───
# macOS
brew install mise
# Linux (推奨)
curl https://mise.run | sh
# npm
npm install -g @jdx/mise
# cargo
cargo install mise
 
# ─── シェル設定 ───
# ~/.zshrc
eval "$(mise activate zsh)"
# ~/.bashrc
eval "$(mise activate bash)"
# ~/.config/fish/config.fish
mise activate fish | source
 
# ─── 基本操作 ───
mise use node@20              # Node.js インストール & 設定
mise use python@3.12          # Python インストール & 設定
mise use go@1.22              # Go インストール & 設定
mise use java@21              # Java インストール & 設定
mise use ruby@3.3             # Ruby インストール & 設定
 
# ─── プロジェクト設定 (.mise.toml) ───
cat << 'EOF' > .mise.toml
[tools]
node = "20"
python = "3.12"
terraform = "1.7"
 
[env]
NODE_ENV = "development"
DATABASE_URL = "postgresql://localhost:5432/mydb"
EOF
 
# mise が .nvmrc, .python-version, .tool-versions も読める
mise ls                       # インストール済み一覧
mise outdated                 # 更新可能なツール表示
mise prune                    # 未使用バージョンの削除

# .mise.toml - 全機能を活用した設定例
 
# ツールバージョン指定
[tools]
node = "20"                    # メジャーバージョン指定（最新パッチを自動選択）
python = "3.12.3"              # 完全バージョン指定
go = "latest"                  # 最新版を常に使用
rust = "1.77.0"                # Rust（rustup 連携）
terraform = "1.7"              # HashiCorp Terraform
kubectl = "1.29"               # Kubernetes CLI
awscli = "2"                   # AWS CLI v2
java = "temurin-21"            # Eclipse Temurin JDK 21
 
# 環境変数設定
[env]
NODE_ENV = "development"
PYTHONDONTWRITEBYTECODE = "1"
RUST_BACKTRACE = "1"
LOG_LEVEL = "debug"
 
# .env ファイルの読み込み
# mise は .env ファイルも自動で読み込める
_.file = ".env"
_.path = "./node_modules/.bin"  # PATH に追加
 
# タスク定義（mise tasks）
[tasks.dev]
run = "npm run dev"
description = "開発サーバー起動"
 
[tasks.test]
run = "npm test"
description = "テスト実行"
 
[tasks.lint]
run = ["npm run lint", "npm run typecheck"]
description = "リント & 型チェック"
 
[tasks.setup]
run = """
npm install
cp .env.example .env
npm run db:migrate
"""
description = "プロジェクト初期セットアップ"

# ─── mise tasks の実行 ───
mise run dev                  # 開発サーバー起動
mise run test                 # テスト実行
mise run lint                 # リント & 型チェック
mise tasks                    # 利用可能タスク一覧
 
# ─── mise のグローバル設定 ───
# ~/.config/mise/config.toml
cat << 'EOF' > ~/.config/mise/config.toml
[tools]
node = "20"          # デフォルトの Node.js バージョン
python = "3.12"      # デフォルトの Python バージョン
 
[settings]
experimental = true   # 実験的機能を有効化
verbose = false       # 詳細出力を無効化
asdf_compat = true    # asdf 互換モード
 
[env]
EDITOR = "code --wait"
EOF

# mise は asdf のドロップイン代替として使える
 
# asdf の .tool-versions をそのまま読める
# .tool-versions
# nodejs 20.11.0
# python 3.12.3
# golang 1.22.0
 
# asdf → mise 移行手順
# 1. mise をインストール
brew install mise
 
# 2. シェル設定を変更
# ~/.zshrc から asdf 関連行を削除
# 以下を追加:
eval "$(mise activate zsh)"
 
# 3. .tool-versions はそのまま使える
# (mise は .tool-versions を自動的に読む)
 
# 4. プラグイン不要
# asdf はプラグインのインストールが必要だったが
# mise は組み込みで多くのツールに対応
 
# 5. 互換性の確認
mise ls                       # asdf で管理していたツールが表示される
 
# 6. 段階的に .mise.toml に移行（任意）
mise settings set asdf_compat true

# ─── インストール ───
git clone https://github.com/go-nv/goenv.git ~/.goenv
 
# ─── シェル設定 (~/.zshrc) ───
export GOENV_ROOT="$HOME/.goenv"
export PATH="$GOENV_ROOT/bin:$PATH"
eval "$(goenv init -)"
export PATH="$GOROOT/bin:$PATH"
export PATH="$GOPATH/bin:$PATH"
 
# ─── 基本操作 ───
goenv install --list           # 利用可能バージョン
goenv install 1.22.0           # インストール
goenv global 1.22.0            # グローバルデフォルト
goenv local 1.22.0             # プロジェクト固定 (.go-version)
goenv versions                 # インストール済み一覧

# goenv の代わりに mise を使う方がシンプル
mise use go@1.22               # Go 1.22 をインストール & 設定
 
# .mise.toml
# [tools]
# go = "1.22"
 
# go.mod の go ディレクティブとの整合性を確認
# go.mod:
# module example.com/myproject
# go 1.22

# ─── インストール ───
curl -s "https://get.sdkman.io" | bash
 
# ─── 基本操作 ───
sdk list java                   # 利用可能バージョン一覧
sdk install java 21.0.2-tem    # Eclipse Temurin JDK 21
sdk install java 21.0.2-graal  # GraalVM CE 21
sdk install java 17.0.10-tem   # JDK 17 (LTS)
sdk use java 21.0.2-tem        # 現在のシェルで切替
sdk default java 21.0.2-tem    # デフォルト設定
sdk current java                # 現在のバージョン
 
# ─── .sdkmanrc でプロジェクト固定 ───
cat << 'EOF' > .sdkmanrc
java=21.0.2-tem
gradle=8.5
maven=3.9.6
EOF
 
sdk env                         # .sdkmanrc の設定を適用
sdk env install                 # .sdkmanrc のツールをインストール
 
# ─── 自動切替の有効化 ───
sdk config
# sdkman_auto_env=true に設定

# SDKMAN の代替として mise を使う
mise use java@temurin-21       # Temurin JDK 21
mise use java@corretto-21      # Amazon Corretto 21
mise use java@graalvm-21       # GraalVM CE 21
 
# .mise.toml
# [tools]
# java = "temurin-21"
 
# 利用可能なディストリビューション
mise ls-remote java | head -20
# temurin-21.0.2
# corretto-21.0.2
# graalvm-21.0.2
# zulu-21.0.2
# liberica-21.0.2

# ─── インストール ───
# macOS
brew install rbenv ruby-build
 
# Linux
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
 
# ─── シェル設定 (~/.zshrc) ───
eval "$(rbenv init - zsh)"
 
# ─── 基本操作 ───
rbenv install --list           # 利用可能バージョン
rbenv install 3.3.0            # インストール
rbenv global 3.3.0             # グローバルデフォルト
rbenv local 3.3.0              # プロジェクト固定 (.ruby-version)
rbenv versions                 # インストール済み一覧
rbenv rehash                   # shim の再構築
 
# ─── mise による代替（推奨） ───
mise use ruby@3.3              # Ruby 3.3 をインストール & 設定

# プロジェクトルートに配置するファイル群
my-project/
├── .node-version          # Node.js バージョン (fnm/nvm対応)
├── .nvmrc                 # nvm 互換 (= .node-version と同じ値)
├── .python-version        # pyenv 用
├── .mise.toml             # mise 用 (統合)
├── .mise.local.toml       # ローカル設定 (.gitignore に追加)
├── rust-toolchain.toml    # Rust 用
├── .go-version            # Go 用 (goenv)
├── .ruby-version          # Ruby 用 (rbenv)
├── .sdkmanrc              # Java 用 (SDKMAN)
└── package.json           # volta の場合はここに記述

#!/usr/bin/env bash
# scripts/sync-versions.sh
# 各ツールのバージョンファイルを統一管理
 
set -euo pipefail
 
# 定義ファイルから読み込み
NODE_VERSION="20.11.0"
PYTHON_VERSION="3.12.3"
 
# Node.js
echo "$NODE_VERSION" > .node-version
echo "$NODE_VERSION" > .nvmrc
 
# Python
echo "$PYTHON_VERSION" > .python-version
 
# mise
cat > .mise.toml << EOF
[tools]
node = "$NODE_VERSION"
python = "$PYTHON_VERSION"
EOF
 
# package.json の engines フィールドを更新
# (jq が必要)
if command -v jq &> /dev/null && [ -f package.json ]; then
  jq --arg node "$NODE_VERSION" \
     '.engines.node = ">=" + ($node | split(".") | .[0] + ".0.0")' \
     package.json > package.json.tmp && mv package.json.tmp package.json
fi
 
echo "バージョンファイルを同期しました"
echo "  Node.js: $NODE_VERSION"
echo "  Python:  $PYTHON_VERSION"

#!/usr/bin/env bash
# scripts/setup-dev.sh
# 新メンバーが最初に実行するスクリプト
 
set -euo pipefail
 
echo "=== 開発環境セットアップを開始します ==="
 
# ─── バージョンマネージャーの確認 ───
check_command() {
  if ! command -v "$1" &> /dev/null; then
    echo "❌ $1 が見つかりません"
    echo "   インストール: $2"
    return 1
  else
    echo "✅ $1 $(eval "$1 --version 2>&1 | head -1")"
  fi
}
 
echo ""
echo "--- ツール確認 ---"
check_command fnm "brew install fnm" || MISSING=true
check_command pyenv "brew install pyenv" || MISSING=true
 
if [ "${MISSING:-}" = "true" ]; then
  echo ""
  echo "不足しているツールをインストールしてから再実行してください"
  exit 1
fi
 
# ─── Node.js バージョンのインストール ───
echo ""
echo "--- Node.js セットアップ ---"
if [ -f .node-version ]; then
  NODE_VER=$(cat .node-version)
  echo "  .node-version: $NODE_VER"
  fnm install "$NODE_VER"
  fnm use "$NODE_VER"
  echo "  ✅ Node.js $(node --version) を使用中"
fi
 
# ─── Python バージョンのインストール ───
echo ""
echo "--- Python セットアップ ---"
if [ -f .python-version ]; then
  PYTHON_VER=$(cat .python-version)
  echo "  .python-version: $PYTHON_VER"
  pyenv install -s "$PYTHON_VER"
  pyenv local "$PYTHON_VER"
  echo "  ✅ Python $(python --version) を使用中"
fi
 
# ─── 依存のインストール ───
echo ""
echo "--- 依存インストール ---"
if [ -f package.json ]; then
  echo "  npm ci を実行中..."
  npm ci
  echo "  ✅ Node.js 依存インストール完了"
fi
 
if [ -f requirements.txt ]; then
  echo "  pip install を実行中..."
  pip install -r requirements.txt
  echo "  ✅ Python 依存インストール完了"
fi
 
echo ""
echo "=== セットアップ完了 ==="

# .github/workflows/ci.yml
name: CI
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
 
      # .node-version / .nvmrc を自動検出
      - uses: actions/setup-node@v4
        with:
          node-version-file: '.node-version'
          cache: 'npm'  # npm キャッシュを有効化
 
      # .python-version を自動検出
      - uses: actions/setup-python@v5
        with:
          python-version-file: '.python-version'
          cache: 'pip'  # pip キャッシュを有効化
 
      - run: npm ci
      - run: npm test

# .github/workflows/rust-ci.yml
name: Rust CI
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
 
      # rust-toolchain.toml を自動検出
      - uses: dtolnay/rust-toolchain@stable
        # rust-toolchain.toml がある場合は自動的に読み込まれる
 
      # Rust のビルドキャッシュ
      - uses: Swatinem/rust-cache@v2
        with:
          cache-on-failure: true
 
      - run: cargo test
      - run: cargo clippy -- -D warnings
      - run: cargo fmt -- --check

# .github/workflows/mise-ci.yml
name: CI with mise
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
 
      # mise で全ツールを一括セットアップ
      - uses: jdx/mise-action@v2
        with:
          experimental: true
 
      # mise が .mise.toml を読んで全ツールをインストール
      - run: node --version
      - run: python --version
      - run: npm ci
      - run: npm test

# Dockerfile
# .node-version の値をビルド引数として受け取る
 
ARG NODE_VERSION=20.11.0
FROM node:${NODE_VERSION}-slim
 
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm ci --production
COPY . .
CMD ["node", "server.js"]

# docker-compose.yml から .node-version を読む
# docker-compose.yml
# services:
#   app:
#     build:
#       context: .
#       args:
#         NODE_VERSION: ${NODE_VERSION:-20.11.0}
 
# ビルド時に .node-version を参照
NODE_VERSION=$(cat .node-version) docker compose build

// renovate.json
{
  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
  "extends": ["config:base"],
  "regexManagers": [
    {
      "fileMatch": ["^\\.node-version$"],
      "matchStrings": ["(?<currentValue>\\d+\\.\\d+\\.\\d+)"],
      "depNameTemplate": "node",
      "datasourceTemplate": "node-version",
      "versioningTemplate": "node"
    },
    {
      "fileMatch": ["^\\.python-version$"],
      "matchStrings": ["(?<currentValue>\\d+\\.\\d+\\.\\d+)"],
      "depNameTemplate": "python",
      "datasourceTemplate": "docker",
      "packageNameTemplate": "python"
    },
    {
      "fileMatch": ["^rust-toolchain\\.toml$"],
      "matchStrings": ["channel\\s*=\\s*\"(?<currentValue>[^\"]+)\""],
      "depNameTemplate": "rust",
      "datasourceTemplate": "docker",
      "packageNameTemplate": "rust"
    }
  ]
}

# 複数のバージョンマネージャーを mise 1つに統合する
 
# Before:
#   fnm (Node.js) + pyenv (Python) + goenv (Go) + rbenv (Ruby)
#
# After:
#   mise (全部)
 
# ─── 現在のバージョンを確認 ───
echo "Node.js: $(node --version)"
echo "Python: $(python --version)"
echo "Go: $(go version)"
echo "Ruby: $(ruby --version)"
 
# ─── mise をインストール ───
brew install mise
 
# ─── シェル設定を一本化 ───
# ~/.zshrc から以下を全て削除:
# eval "$(fnm env --use-on-cd --shell zsh)"
# eval "$(pyenv init -)"
# eval "$(pyenv virtualenv-init -)"
# eval "$(goenv init -)"
# eval "$(rbenv init - zsh)"
 
# 代わりに:
# eval "$(mise activate zsh)"
 
# ─── 必要なバージョンをインストール ───
mise use --global node@20
mise use --global python@3.12
mise use --global go@1.22
mise use --global ruby@3.3
 
# ─── プロジェクトの .mise.toml を作成 ───
cat << 'EOF' > .mise.toml
[tools]
node = "20.11.0"
python = "3.12.3"
go = "1.22.0"
ruby = "3.3.0"
EOF
 
# ─── 動作確認 ───
mise ls                       # 全ツール一覧
node --version
python --version
go version
ruby --version
 
# ─── 古いツールを削除 ───
brew uninstall fnm
brew uninstall pyenv pyenv-virtualenv
rm -rf ~/.goenv
brew uninstall rbenv

# ─── node が見つからない場合 ───
 
# 1. バージョンマネージャーがロードされているか確認
which fnm        # fnm 自体のパスが返るか
fnm current      # 現在のバージョンが表示されるか
 
# 2. シェル設定が正しいか確認
cat ~/.zshrc | grep fnm
# eval "$(fnm env --use-on-cd --shell zsh)" が含まれているか
 
# 3. fnm にバージョンがインストールされているか
fnm list
# 何も表示されない場合:
fnm install --lts
 
# 4. 新しいシェルを開いて確認
exec zsh
node --version
 
# ─── pyenv の python が見つからない場合 ───
 
# 1. pyenv のシム確認
which python
# ~/.pyenv/shims/python が返るべき
 
# 2. shim の再構築
pyenv rehash
 
# 3. バージョンが設定されているか確認
pyenv version
# "system" と表示される場合は未設定
pyenv global 3.12.3

# ─── cd しても自動切替が動かない場合 ───
 
# 1. fnm の --use-on-cd が有効か確認
fnm env | grep "FNM_VERSION_FILE_STRATEGY"
# "recursive" が推奨
 
# 2. .node-version ファイルの内容確認
cat .node-version
# 改行コードに注意（LF であるべき、CRLF だと問題になることがある）
file .node-version
# "ASCII text" と表示されるべき
 
# 3. バージョンが実際にインストールされているか
fnm list
# .node-version に書かれたバージョンが一覧にあるか
 
# 4. 手動切替は動くか
fnm use
# エラーが出る場合は fnm install を先に実行
 
# ─── Volta で切り替わらない場合 ───
# package.json の volta フィールドを確認
cat package.json | jq '.volta'
# null の場合は volta pin node@20 を実行

# ─── 複数のバージョンマネージャーが競合する場合 ───
 
# 1. 全ての node の場所を確認
which -a node
type -a node
 
# 期待される出力（fnm の場合）:
# /Users/username/.fnm/node-versions/v20.11.0/installation/bin/node
 
# 問題のある出力例:
# /opt/homebrew/bin/node          ← brew install node の残骸
# /Users/username/.nvm/versions/node/v20.11.0/bin/node  ← nvm の残骸
# /Users/username/.fnm/node-versions/v20.11.0/installation/bin/node
 
# 2. 不要なインストールを削除
brew uninstall node              # Homebrew の node を削除
rm -rf ~/.nvm                    # nvm を完全削除
 
# 3. PATH の順序を確認
echo $PATH | tr ':' '\n' | head -20
# バージョンマネージャーのパスが /usr/local/bin より前にあるべき
 
# 4. シェル設定で不要なパスが追加されていないか確認
grep -n 'PATH' ~/.zshrc
grep -n 'PATH' ~/.zprofile
grep -n 'PATH' ~/.bash_profile

# ─── macOS Sonoma/Sequoia でのビルドエラー ───
 
# "Build failed" の場合のデバッグ手順:
 
# 1. Xcode Command Line Tools を更新
xcode-select --install
# 既にインストール済みの場合:
sudo rm -rf /Library/Developer/CommandLineTools
xcode-select --install
 
# 2. ビルド依存を再インストール
brew reinstall openssl readline sqlite3 xz zlib tcl-tk
 
# 3. 環境変数を設定してビルド
LDFLAGS="-L$(brew --prefix openssl@3)/lib \
  -L$(brew --prefix readline)/lib \
  -L$(brew --prefix sqlite3)/lib \
  -L$(brew --prefix zlib)/lib \
  -L$(brew --prefix xz)/lib" \
CPPFLAGS="-I$(brew --prefix openssl@3)/include \
  -I$(brew --prefix readline)/include \
  -I$(brew --prefix sqlite3)/include \
  -I$(brew --prefix zlib)/include \
  -I$(brew --prefix xz)/include" \
PKG_CONFIG_PATH="$(brew --prefix openssl@3)/lib/pkgconfig:\
$(brew --prefix readline)/lib/pkgconfig:\
$(brew --prefix sqlite3)/lib/pkgconfig:\
$(brew --prefix zlib)/lib/pkgconfig:\
$(brew --prefix xz)/lib/pkgconfig" \
pyenv install 3.12.3
 
# 4. それでもダメなら uv を代替として検討
uv python install 3.12  # プリビルドバイナリなのでビルドエラーなし