dotfilesと環境変数の実践管理ガイド

# ログインシェルが読むファイル:
# 1. /etc/profile         — システム全体の設定（常に読まれる）
# 次に以下の1つを探す（最初に見つかったもので止まる）:
# 2. ~/.bash_profile      — ユーザーのログイン設定
# 3. ~/.bash_login        — .bash_profileがなければこれ
# 4. ~/.profile           — 上の2つもなければこれ

# 非ログインインタラクティブシェルが読むファイル:
# 1. /etc/bash.bashrc     — システム全体（ディストロによる）
# 2. ~/.bashrc            — ユーザーの設定

# ~/.bash_profile
# ログインシェルでも.bashrcの設定を適用する
[[ -f ~/.bashrc ]] && source ~/.bashrc

# すべてのZshセッション:
# 1. /etc/zshenv      → ~/.zshenv        — 常に読まれる（スクリプトでも）

# ログインシェルはさらに:
# 2. /etc/zprofile    → ~/.zprofile       — ログイン固有
# 3. /etc/zshrc       → ~/.zshrc          — インタラクティブ設定
# 4. /etc/zlogin      → ~/.zlogin         — .zshrcの後

# インタラクティブ非ログインシェル:
# 1. /etc/zshenv      → ~/.zshenv
# 2. /etc/zshrc       → ~/.zshrc

# ログアウト時:
# ~/.zlogout → /etc/zlogout

# ~/.zshenv — 環境変数（常に読まれる）
export EDITOR="nvim"
export LANG="ja_JP.UTF-8"

# ~/.zshrc — インタラクティブ専用（プロンプト、エイリアス、補完）
autoload -Uz compinit && compinit
alias ll='ls -lah'

┌──────────────────────────────────────────────────┐
│                  BASH                            │
│                                                  │
│  ログイン:       /etc/profile → ~/.bash_profile  │
│  インタラクティブ: /etc/bash.bashrc → ~/.bashrc  │
│  スクリプト:     （デフォルトではなし）             │
├──────────────────────────────────────────────────┤
│                  ZSH                             │
│                                                  │
│  常に:           /etc/zshenv → ~/.zshenv         │
│  ログイン:       + ~/.zprofile → ~/.zshrc        │
│  インタラクティブ: + ~/.zshrc                     │
│  スクリプト:     ~/.zshenvのみ                    │
└──────────────────────────────────────────────────┘

# 変数を設定（このシェルのみ有効）
MY_VAR="hello"

# exportする（子プロセスに継承される）
export MY_VAR="hello"

# 設定とexportを1行で（最も一般的）
export EDITOR="nvim"
export GOPATH="$HOME/go"

# 全環境変数を表示
env
# または
printenv

# 特定の変数を確認
echo $PATH
printenv PATH

# 典型的なLinuxのPATH
echo $PATH
# /home/furuya/.local/bin:/usr/local/bin:/usr/bin:/bin

# PATHにディレクトリを追加（先頭 = 優先度高）
export PATH="$HOME/.local/bin:$PATH"

# 末尾に追加（優先度低）
export PATH="$PATH:$HOME/go/bin"

# ~/.bashrc — PATH構築
# 存在するディレクトリだけ追加する
add_to_path() {
  [[ -d "$1" ]] && [[ ":$PATH:" != *":$1:"* ]] && export PATH="$1:$PATH"
}

add_to_path "$HOME/.local/bin"
add_to_path "$HOME/.cargo/bin"
add_to_path "$HOME/go/bin"
add_to_path "$HOME/.npm-global/bin"

# .env（Gitにコミットしない）
DATABASE_URL="postgres://user:pass@localhost:5432/32blog_dev"
STRIPE_SECRET_KEY="sk_test_abc123"
NEXTAUTH_SECRET="random-secret-here"

# .env.example（Gitにコミットする — 実際の値は入れない）
DATABASE_URL="postgres://user:pass@localhost:5432/mydb"
STRIPE_SECRET_KEY="sk_test_..."
NEXTAUTH_SECRET="generate-with-openssl-rand"

# シークレットを保存
pass insert dev/github-token

# シェル設定で使う
export GITHUB_TOKEN=$(pass show dev/github-token)

~/.config/git/config       # ~/.gitconfig の代わり
~/.config/htop/htoprc      # htopの設定
~/.config/btop/btop.conf   # btopの設定
~/.config/nvim/init.lua    # Neovimの設定

export XDG_CONFIG_HOME="$HOME/.config"
export XDG_DATA_HOME="$HOME/.local/share"
export XDG_STATE_HOME="$HOME/.local/state"
export XDG_CACHE_HOME="$HOME/.cache"

# XDGディレクトリを使うように設定
export HISTFILE="$XDG_STATE_HOME/bash/history"
export LESSHISTFILE="$XDG_STATE_HOME/less/history"
export NPM_CONFIG_USERCONFIG="$XDG_CONFIG_HOME/npm/npmrc"
export DOCKER_CONFIG="$XDG_CONFIG_HOME/docker"
export CARGO_HOME="$XDG_DATA_HOME/cargo"
export GOPATH="$XDG_DATA_HOME/go"
export RUSTUP_HOME="$XDG_DATA_HOME/rustup"

# GNU Stowのインストール（2024年時点で2.4.1）
sudo apt install stow     # Debian/Ubuntu
sudo pacman -S stow        # Arch
brew install stow          # macOS

mkdir -p ~/dotfiles
cd ~/dotfiles
git init

# ファイルの配置先をミラーしたディレクトリを作成
mkdir -p bash/.config
mkdir -p git/.config/git
mkdir -p nvim/.config/nvim
mkdir -p tmux/.config/tmux

# .bashrcをbashパッケージに移動
mv ~/.bashrc ~/dotfiles/bash/

# Git設定を移動
mv ~/.config/git/config ~/dotfiles/git/.config/git/config

# Neovim設定を移動
mv ~/.config/nvim/init.lua ~/dotfiles/nvim/.config/nvim/init.lua

cd ~/dotfiles

# 各パッケージをstow — $HOMEにシンボリックリンクが作成される
stow bash       # ~/.bashrc → ~/dotfiles/bash/.bashrc
stow git        # ~/.config/git/config → ~/dotfiles/git/.config/git/config
stow nvim       # ~/.config/nvim/init.lua → ~/dotfiles/nvim/.config/nvim/init.lua
stow tmux

# まとめてstow
stow */

# パッケージのシンボリックリンクを削除
stow -D bash

# 再stow（削除して再作成 — ファイル追加時に便利）
stow -R bash

cd ~/dotfiles
git add -A
git commit -m "feat: add initial dotfiles"
git remote add origin git@github.com:your-username/dotfiles.git
git push -u origin main

git clone git@github.com:your-username/dotfiles.git ~/dotfiles
cd ~/dotfiles
stow */

# chezmoiをインストール
sh -c "$(curl -fsLS get.chezmoi.io)"

# 既存のdotfilesリポから初期化
chezmoi init --apply your-username

# ファイルをchezmoiの管理下に追加
chezmoi add ~/.bashrc

# 管理対象ファイルを編集
chezmoi edit ~/.bashrc

# 変更内容を確認
chezmoi diff

# 変更を適用
chezmoi apply

# ~/.local/share/chezmoi/dot_bashrc.tmpl
export EDITOR="nvim"

{{ if eq .chezmoi.hostname "work-laptop" }}
export HTTP_PROXY="http://proxy.corp.example.com:8080"
{{ end }}

{{ if eq .chezmoi.os "darwin" }}
eval "$(/opt/homebrew/bin/brew shellenv)"
{{ end }}

# 初期化
git init --bare $HOME/.dotfiles

# エイリアスを作成
alias dotfiles='git --git-dir=$HOME/.dotfiles --work-tree=$HOME'

# 未追跡ファイルを非表示
dotfiles config --local status.showUntrackedFiles no

# 通常のgitと同じように使う
dotfiles add ~/.bashrc
dotfiles commit -m "add bashrc"
dotfiles push

# direnvをインストール
sudo apt install direnv     # Debian/Ubuntu
sudo pacman -S direnv       # Arch
brew install direnv          # macOS

# シェルにフックを設定（.bashrcまたは.zshrcに追加）
eval "$(direnv hook bash)"    # Bash用
eval "$(direnv hook zsh)"     # Zsh用

# プロジェクトに.envrcを作成
cd ~/projects/32blog
echo 'export NODE_ENV="development"' > .envrc

# direnvはセキュリティ上、承認するまでブロックする
direnv: error /home/furuya/projects/32blog/.envrc is blocked.
Run `direnv allow` to approve its content.

# 承認する
direnv allow

# このディレクトリにいる間、NODE_ENVがセットされる
echo $NODE_ENV
# development

# ディレクトリを出ると自動的にアンロードされる
cd ~
echo $NODE_ENV
# （空）

# ~/projects/32blog/.envrc

# .envファイルを読み込む（よくあるパターン）
dotenv

# プロジェクトローカルのバイナリをPATHに追加
PATH_add node_modules/.bin
PATH_add .bin

# プロジェクト固有のツールバージョンを設定
export NODE_VERSION="22.14.0"
use node

# チーム共有の設定をsource
source_env ../.shared-env

# このプロジェクト用のAWSプロファイル
export AWS_PROFILE="32blog-prod"

# .envrc（Gitにコミットする）
dotenv
PATH_add node_modules/.bin
export NODE_ENV="development"

# .env（コミットしない — .gitignoreに追加）
DATABASE_URL="postgres://..."
API_SECRET="..."

# ~/projects/32blog/.envrc
dotenv                         # .envを読み込む
PATH_add node_modules/.bin     # ローカルのeslint、prettierなどを使う
export NEXT_TELEMETRY_DISABLED=1

if [[ "$(uname)" == "Darwin" ]]; then
  eval "$(/opt/homebrew/bin/brew shellenv)"
fi

# docker-compose.yml
services:
  app:
    env_file: .env