dotfiles

這個 repository 是我的 macOS 開發環境設定集合。它的用途是把常用 shell 設定、alias、function、Git 設定與低風險 macOS 偏好集中管理，讓新機器或重裝環境時可以快速恢復熟悉的工作方式。

目前這份設定已改成 zsh-first：主要 shell 是 zsh，prompt 使用 Starship，不再依賴舊的 bash prompt、oh-my-zsh theme 或 powerline 設定。

這份 dotfiles 會做什麼

• 建立 zsh 開發環境入口：載入 PATH、alias、function、補完、zoxide 與 Starship prompt。
• 管理常用命令別名：例如 ll、tree、grep、Laravel / Composer 快捷命令。
• 提供常用 shell function：例如建立並進入目錄、啟動本機 HTTP server、格式化 JSON、查憑證名稱、計算檔案 gzip 後大小。
• 安裝時互動詢問 Git name/email，並由 template 產生 ~/.gitconfig。
• 套用低風險 macOS defaults：Finder、Dock、Safari、TextEdit、截圖位置等偏好。
• 用 Brewfile 記錄建議安裝的現代 CLI 工具。
• 用 install.sh 建立家目錄 symlink，並在覆蓋既有檔案前自動備份。

不會做什麼

這份 dotfiles 已移除高風險或過時行為：

• 不再部署 bash dotfiles 作為主要入口。
• 不再載入 Python 2、bower、Heroku Toolbelt、舊 RVM autoload、舊 powerline。
• 不會關閉 macOS quarantine。
• 不會寫入 nvram。
• 不會重建 Spotlight index。
• 不會刪除或重建 Launchpad database。
• 不會自動安裝 oh-my-zsh。

檔案說明

檔案	用途
.zshrc	zsh 主要入口，載入共用設定、補完、fzf、zoxide 與 Starship
.exports	PATH、locale、pager、editor、history 等環境變數
.aliases	常用命令 alias，優先使用 eza、bat、rg、delta、lazygit 等現代工具
.functions	常用 shell function
.config/starship.toml	Starship prompt 設定
.osx	低風險 macOS defaults
.gitconfig.template	Git alias、color、LFS filter 與互動產生使用者資訊的 template
Brewfile	建議安裝的 Homebrew 套件
install.sh	建立 symlink 的安裝腳本

建議工具

Brewfile 目前包含：

• starship：跨 shell prompt。
• zoxide：更聰明的 cd，會記住常用目錄並用 z 快速跳轉。
• fzf：模糊搜尋。
• ripgrep：快速搜尋文字。
• fd：快速搜尋檔案。
• bat：現代版 cat。
• eza：現代版 ls。
• jq：JSON 處理。
• git-delta：更好讀的 Git diff pager。
• lazygit：terminal 裡的 Git 操作介面，可用 lg 啟動。

安裝

先預覽會執行哪些安裝與 symlink：

./install.sh --dry-run

確認後安裝：

./install.sh

安裝腳本預設會先執行 brew bundle --file Brewfile，安裝 Starship、fzf、zoxide 等 CLI 工具，接著才建立家目錄 symlink。若只想更新 dotfile symlink、不想動 Homebrew 套件，可以用：

./install.sh --skip-brew

安裝時會詢問 Git 使用者資訊：

Git user.name [Eugene]:
Git user.email [[email protected]]:

直接按 Enter 會沿用目前 git config --global 裡的值。

安裝腳本會把既有的一般檔案備份到：

~/.dotfiles-backup/YYYYMMDD-HHMMSS/

套用 macOS defaults

確認 .osx 內容後執行：

~/.osx

這份 .osx 只保留低風險設定。部分 macOS defaults 需要重新登入或重開機才會完整生效。

Starship

.zshrc 會使用：

export STARSHIP_CONFIG="${HOME}/.config/starship.toml"
eval "$(starship init zsh)"

如果系統尚未安裝 Starship，會暫時退回簡單 zsh prompt，不會讓 shell 啟動失敗。

更新流程

修改設定後建議先做基本檢查：

zsh -n .zshrc
zsh -n .aliases
zsh -n .exports
zsh -n .functions
zsh -n install.sh
zsh -n .osx
./install.sh --dry-run

Starship 設定可用：

STARSHIP_CONFIG="$PWD/.config/starship.toml" starship explain