Dotfile（點檔案）

你會在什麼時候遇到它

shell 的個性寫在 ~/.zshrc、git 的身分寫在 ~/.gitconfig、SSH 金鑰放在 ~/.ssh/、專案的 API key 放在 .env —— AI 開發環境的幕後設定幾乎全是點檔案。教學說「把這行加進你的 .zshrc」「在專案根目錄建 .env」時，你得知道這些檔案預設是藏起來的：ls 看不到、Finder 也看不到，你甚至會懷疑自己剛剛到底有沒有建成功。

最小範例

touch .demo        # 建一個檔名以 . 開頭的檔案
ls                 # 清單裡沒有它
ls -a              # 加 -a 才看得到（同時會看到 . 和 .. 兩個目錄）
rm .demo           # 清理掉

「隱藏」只是 ls 和 Finder 的預設顯示行為，不是加密也不是保護 —— 任何程式都讀得到它們。macOS Finder 按 Command+Shift+. 可以切換顯示。這個慣例來自早期 Unix：工具會跳過以 . 開頭的檔名，後來大家就拿它放「不想擋到視線」的設定。

最常搞錯的地方

• ls 之後沒看到 .env 或 .gitignore，就認定「這個專案沒有設定」。先用 -a 再看一次 —— 你剛裝好的工具，很可能早已把設定寫進某個點檔案裡。
• 把帶機密的點檔案（.env、~/.ssh 裡的私鑰）跟著其他檔案一起提交進 git。點只是讓檔案在清單裡隱藏，不會對 git 隱藏：提交推上去就是公開。.env 要寫進 .gitignore —— 而 .gitignore 本身也是點檔案。