Zsh Configuration - 模組化 Shell 環境配置

使用 Dotfiles Management 專案的模組化 Zsh 配置系統，提供跨平台支援、智能環境管理和高效能插件管理。

🛠️ Dotfiles 中的 Zsh 配置系統

模組化架構

zsh/
├── kywk.zshrc         # 主配置檔案 (入口點)
├── common.zshrc       # 通用設定 (基礎功能)
├── zinit.zshrc        # Zinit 插件管理 (Turbo 模式)
├── mac.zshrc          # macOS 專用配置
├── linux.zshrc        # Linux 專用配置
├── performance.zshrc  # 效能最佳化配置
└── functions/         # 自訂函數庫
    ├── git-helpers.zsh
    ├── dev-tools.zsh
    └── system-utils.zsh

🎆 核心特色

• ⚡ Turbo 模式 - Zinit 延遲載入，啟動速度提升 50%+
• 🌍 跨平台 - 自動檢測 macOS/Linux 並載入對應配置
• 🔧 智能環境 - 根據專案檔案自動切換版本
• 🔒 防污染 - 最小化 .zshrc，避免其他工具污染
• 📦 模組化 - 功能分離，易於維護和擴展
• 🔄 同步機制 - Dropbox 跨設備配置同步

效能指標

指標	傳統配置	Dotfiles 配置	改善幅度
啟動時間	~800ms	~300ms	📈 62%
記憶體使用	~45MB	~28MB	📈 38%
插件載入	同步	非同步	⚡ 即時回應
配置管理	手動	自動化	🤖 無需介入

🚀 快速安裝與配置

一鍵安裝 (推薦)

# 使用 dotfiles 專案自動安裝
cd ~/.files && ./init.sh

# 或單獨安裝 Zsh 配置
./bin/setup-zsh.sh

手動安裝

# 1. 建立 symbolic link
ln -sf ~/.files/zsh/kywk.zshrc ~/.zshrc

# 2. 安裝 Zinit (如果尚未安裝)
bash -c "$(curl --fail --show-error --silent --location https://raw.githubusercontent.com/zdharma-continuum/zinit/HEAD/scripts/install.sh)"

# 3. 重新載入 Shell
source ~/.zshrc

# 4. 驗證安裝
echo $ZSH_VERSION
zinit version

初次設定

# 配置 Powerlevel10k 主題 (首次啟動時會自動執行)
p10k configure

# 更新所有插件
zinit update --all

# 測試效能
time zsh -i -c exit

📝 配置檔案詳解

kywk.zshrc (主配置)

#!/usr/bin/env zsh
# ~/.files/zsh/kywk.zshrc
# 主配置檔案 - 最小化設計，避免污染

# 載入基礎配置
source ~/.files/zsh/common.zshrc

# 載入插件管理器
source ~/.files/zsh/zinit.zshrc

# 跨平台支援
case "$OSTYPE" in
  darwin*)  source ~/.files/zsh/mac.zshrc ;;
  linux*)   source ~/.files/zsh/linux.zshrc ;;
esac

# 載入本地客製化設定 (可選)
[[ -f ~/.config/local.zsh ]] && source ~/.config/local.zsh

common.zshrc (基礎配置)

# 基礎 Shell 設定
export HISTSIZE=10000
export SAVEHIST=10000
export HISTFILE=~/.zsh_history

# 歷史記錄選項
setopt HIST_IGNORE_DUPS
setopt HIST_IGNORE_SPACE
setopt HIST_VERIFY
setopt SHARE_HISTORY

# 目錄導航
setopt AUTO_CD
setopt AUTO_PUSHD
setopt PUSHD_IGNORE_DUPS

# 自動補全
autoload -Uz compinit
compinit

智能環境管理

版本自動切換：

# 根據專案檔案自動切換版本
# .nvmrc -> Node.js 版本
# pom.xml -> Java 版本  
# go.mod -> Go 版本

# 目錄變更時觸發
chpwd() {
  [[ -f .nvmrc ]] && nvm use
  [[ -f pom.xml ]] && sdk use java
  [[ -f go.mod ]] && export GOPATH=$(pwd)
}

🔧 進階功能與客製化

自訂函式庫

Git 輔助函式：

# ~/.files/zsh/functions/git-helpers.zsh

# 快速提交
gc() {
  git add . && git commit -m "$1" && git push
}

# 分支切換
gb() {
  git checkout -b "$1" 2>/dev/null || git checkout "$1"
}

# 狀態概覽
gs() {
  git status --short --branch
}

開發工具：

# ~/.files/zsh/functions/dev-tools.zsh

# 專案初始化
proj() {
  mkdir -p "$1" && cd "$1"
  git init
  echo "# $1" > README.md
}

# 埠口檢查
port() {
  lsof -i :"$1" | grep LISTEN
}

# 快速服務器
serve() {
  python3 -m http.server "${1:-8000}"
}

環境變數管理

# ~/.config/local.zsh (本地客製化)

# 開發環境路徑
export WORKSPACE="$HOME/workspace"
export PROJECTS="$HOME/projects"

# API 金鑰 (不進版控)
export OPENAI_API_KEY="your-key-here"
export GITHUB_TOKEN="your-token-here"

# 工具配置
export EDITOR="code"
export BROWSER="open"

效能監控與調校

啟動時間分析：

# 測量啟動時間
zsh-benchmark() {
  for i in {1..5}; do
    time zsh -i -c exit
  done
}

# 詳細效能分析
zsh-profile() {
  zmodload zsh/zprof
  source ~/.zshrc
  zprof
}

資源使用監控：

# 記憶體使用
zsh-memory() {
  ps -o pid,ppid,rss,comm -p $$
}

# 插件載入時間
zinit times | sort -k2 -n

🔍 故障排除與維護

常見問題

權限問題：

# 修復目錄權限
sudo chown -R $(whoami) ~/.zsh*
chmod 755 ~/.files/zsh/*.zsh

色彩顯示問題：

# 啟用 LS_COLORS
export CLICOLOR=1
export LSCOLORS=ExFxBxDxCxegedabagacad

# 或使用 GNU ls colors
export LS_COLORS='di=34:ln=35:so=32:pi=33:ex=31:bd=46;34:cd=43;34:su=41;30:sg=46;30'

插件載入失敗：

# 清除 Zinit 快取
zinit cclear

# 重新安裝插件
zinit delete <plugin-name>
zinit load <plugin-name>

# 重建補全系統
rm -f ~/.zcompdump*
autoload -U compinit && compinit

維護指令

# 更新所有組件
~/.files/bin/update-zsh.sh

# 備份配置
~/.files/bin/backup-config.sh

# 健康檢查
~/.files/bin/health-check.sh --zsh

📚 參考資源

相關工具

• Dotfiles Management - 完整的 dotfiles 管理系統
• Zinit - Zsh 插件管理器配置

學習資源

官方文件：

• Zsh 官方文件 - 權威指南
• Zsh 用戶指南 - 入門教學

社群資源：

• This Zsh config is perhaps my favorite one yet. - YouTube
• zsh 透過 zinit 安裝 Powerlevel10k 佈景主題 - Code and Me
• 用 LS_COLOR 在 Terminal 中為檔名加上色彩吧！

故障排除：

• zsh permission denied when accessing my home directory - Stack Overflow
• terminal - Zsh not recognizing ls colors - Super User

✅ 已完成功能

功能類別	狀態	說明
插件管理	✅	Zinit Turbo 模式
自動補全	✅	zsh-completions
語法高亮	✅	fast-syntax-highlighting
歷史建議	✅	zsh-autosuggestions
主題配置	✅	Powerlevel10k
跨平台支援	✅	macOS/Linux 自動檢測
版本管理整合	✅	NVM/SDKMAN/Volta
效能最佳化	✅	延遲載入 + 快取

🚀 未來規劃

• AI 輔助命令建議
• 更多自訂函式庫
• 專案模板系統
• 雲端配置同步
• 效能監控面板