dotfiles：以 Lua 為核心的 macOS 生產力配置集合

Thu, 07 May 2026 00:00:00 +0000

# Introduction（引言）

在跨多台 Mac、跨系統重灌的長期使用情境中，缺乏版本控管的個人設定往往導致重複勞動與環境不一致。研究與臨床工作的特殊需求（如多語系輸入、特定快捷鍵、與 Claude Code／Windsurf 等 AI Coding 工具的整合）更使「可重現的開發環境」成為個人生產力的基礎建設。本 dotfiles 專案即是一份個人化、Lua 主導且持續演進的 macOS 配置記錄。

# Methods（方法）

設定以四個核心元件為骨架：Neovim 提供主要編輯體驗，Zsh 處理 shell 與工作流，Tmux 管理多會話與遠端連線，Hammerspoon 則以 Lua 腳本接管 macOS 的視窗管理、應用切換與全域快捷鍵。整體配置採模組化設計，各元件獨立但共享一致的命名習慣與顏色主題，可在新機上以 symlink 一鍵部署。

特別著重於與 AI Coding 工具的整合：Hammerspoon 提供觸發 Claude Code、Windsurf 的快捷鍵；Neovim 設定包含對 LLM 工具如 avante、aider 的支援；Tmux 設計利於多 session 同步監看背景任務。設定演進過程透過 Git 歷史保留，使任何破壞性變更皆可被回溯。

# Results（結果）

此 dotfiles 已涵蓋作者跨多年累積的快捷鍵與工作流細節，可在新 Mac 上以最少時間還原個人化環境。Lua 為主的選擇使設定具備可程式化與良好的型別檢查，相較於傳統 Vimscript 與 Bash 在維護性上有顯著優勢。專案亦作為公開資源供其他使用者參考，特別是對於想將 AI Coding 工具納入日常工作流的醫師與研究者。

# Discussion（討論）

dotfiles 是個人生產力的「程式化文件」：每一行設定都是某個工作流問題的回應。其價值在於穩定、可攜、可分享。限制方面，Hammerspoon 等工具高度綁定 macOS，在 Linux 上需替代方案；Lua 設定的學習曲線對非工程背景使用者較陡。未來可加入更系統的 README 與適合醫師背景者的入門指南，並提供 Codespaces／Devcontainer 模板，讓臨床醫師快速嘗試 AI Coding 工具鏈。

# 連結