一個專案的樣子

開啟一個典型的專案，那一長串資料夾清單可能讓人覺得像噪音。它不是——大多數專案都遵循一種認得出來的套路。下面是一個精簡過的網頁應用：

my-app/
├── package.json          # 依賴 + 執行命令（見上文）
├── package-lock.json     # 鎖檔案 lockfile —— 精確的版本
├── .env                  # 本地的金鑰/配置 —— 不要共享
├── .gitignore            # Git 應該忽略的檔案（比如 .env）
├── README.md             # 這個專案是什麼，怎麼執行它
├── public/               # 原樣提供的靜態檔案（圖片、圖示）
└── src/                  # 你真正的程式碼住在這裡
    ├── components/        # 可複用的 frontend 部件（一個按鈕、一張卡片）
    ├── pages/ (or app/)   # 使用者導航到的那些介面/路由
    ├── lib/               # 共享的輔助程式碼和 backend 邏輯
    └── styles/            # CSS

你不用把這個背下來——只要認得出來就行，這樣當 AI 說 "我會把這個加到 src/lib 裡" 時，你大致知道那是在哪裡、為什麼在那裡。有幾條起承重作用的約定：

• src/ 裝著你寫的程式碼。最頂層那些雜亂的東西基本上都是配置。
• 根目錄下的配置檔案（那個 package.json、那些點開頭的檔案）配置的是工具，而不是你應用的行為。
• .gitignore 列出那些不應該被存進版本控制的檔案——你的 .env 就屬於這裡，而這正是金鑰得以不進入共享倉庫的辦法。