AI 開發踩坑日記：我犯過的錯，你不用再犯
踩坑是這條路上最好的老師
我不是工程師。我是財務顧問。
三個月前，我對程式碼一竅不通。現在，我一個人架了一個品牌網站、一套 AI 安全掃描器、一個 Agent Fleet 自動化系統，還在變現。
這中間踩了多少坑？多到我可以寫一本書。
但我不覺得踩坑是壞事。每一個坑，都變成了我可以分享給別人的經驗。 你踩過的坑，就是你最有價值的內容。
這篇文章，是我把最痛的那些坑整理出來，讓你少走彎路。
坑 #1：眼花撩亂症候群
第一次用 AI 開發，你會同時遇到這些東西：
- Firebase（資料庫）
- Vercel（部署平台）
- API Key（各種金鑰）
- Git Push（版本控制）
- 環境變數（.env 檔案）
- npm / node_modules（套件管理）
每一個都是你沒聽過的名詞。每一個都有自己的設定方式。每一個都可能出錯。
你的第一反應會是：「這也太多了吧？」
正常。每個人都是這樣。
怎麼解？
不要試圖一次搞懂所有東西。
你不需要理解 Firebase 的底層架構。你需要知道的是：「資料存在這裡，用這個指令讀取。」
你不需要理解 Git 的 DAG 模型。你需要知道的是：「改完存檔，推上去。」
把每個工具想成一個黑盒子。你只需要知道：輸入什麼、輸出什麼、壞了怎麼辦。
細節？等你真的需要的時候再學。大多數時候，你永遠不需要。
坑 #2：沒在本地測試就 Push
這是新手最常犯的錯，我也不例外。
改了一段程式碼，覺得應該沒問題，直接 git push，然後部署到線上 — 結果網站炸了。
更慘的是，有時候你不知道它炸了。因為你沒有去看。等你發現的時候，可能已經炸了好幾個小時。
教訓
在本地測試，測試完畢再 Push。
正確流程：
改程式碼 → npm run dev → 打開瀏覽器看 → 確認沒問題 → git push
錯誤流程：
改程式碼 → git push → 祈禱 → 爆炸
這聽起來像廢話，但你不知道有多少人（包括我）是在線上環境 debug 的。那種感覺就像在高速公路上換輪胎。
npm run dev 就是你的安全網。每次改完，先在本地跑一次。 這個習慣會省你無數個小時。
坑 #3：API Key 外洩
這個坑不只是痛，是會痛到錢包的。
API Key 是什麼？簡單說，就是你用來連接外部服務的密碼。比如 Google 的 AI 服務、寄信服務、資料庫 — 都需要一把 Key。
新手最常犯的錯：把 API Key 直接寫在程式碼裡，然後推到 GitHub。
GitHub 是公開的。你的 Key 一推上去，全世界都看得到。然後就會有人拿你的 Key 去用，帳單算在你頭上。
我的血淚教訓
有一次，一把 Gemini API Key 是從有開啟計費的 Google Cloud 專案建出來的。七天，$127.80 美金。
因為開了計費，就沒有免費額度的限制。AI 的 thinking tokens 每百萬個要 $3.50，而且沒有速率限制。
怎麼防？
1. API Key 永遠放在 .env 檔案裡
2. .env 檔案永遠加進 .gitignore
3. 永遠不要把 .env 推到 GitHub
4. 用完的 Key 定期輪換
5. 雲端服務的計費頁面，設定預算警報
如果你只記一條：.env 不進 Git。
坑 #4：有產品，沒有人
這是我踩過最大的坑，而且不是技術坑 — 是思維坑。
當你開始用 AI 開發，你會發現做產品變得很快。幾天就能做出一個網站、一個工具、一個系統。
然後你會掉進一個陷阱：一直在做產品，忘了找人用。
你花了兩週做了一個很酷的東西。上線了。然後呢？沒人知道，沒人用，沒人在乎。
正確的順序
❌ 先做產品 → 再找人
✅ 先找人 → 邊做產品
行銷要先跑。
在你的產品還沒做完之前，你就應該開始：
- 在 Threads / 社群上記錄你的開發過程
- 讓你的帳號開始互動，接觸「人」
- 分享你正在做的事，讓人知道你的存在
等產品做完了，你已經有一群人在關注你。他們會是你的第一批使用者、第一批回饋者、第一批客戶。
如果你等產品做完才開始行銷，你就要從零開始。而從零開始，比你想像的難得多。
坑 #5：Vercel 部署的各種小地雷
Vercel 是一個很棒的部署平台，免費版就夠用。但它有一些新手不會知道的地雷：
地雷 1：不要在 api/ 資料夾建 tsconfig.json
Vercel 會自動處理 TypeScript 編譯。你手動建一個 tsconfig.json，反而會把所有 API endpoint 搞壞。
地雷 2：環境變數的換行符
在設定環境變數的時候，用 echo 會多一個換行符。你的 API Key 後面多了一個看不見的字元，然後怎麼都連不上。
解法：用 printf 而不是 echo。
地雷 3：Hobby Plan 的 12 個函式限制
Vercel 免費版最多 12 個 serverless function。你不會一開始就碰到這個限制，但當你的產品越做越多功能，突然就滿了。
解法：把相關功能合併到同一個 endpoint。
坑 #6：Firebase 的「免費」不是真的免費
Firebase Firestore 的免費額度是每天 50K reads。聽起來很多？
如果你的頁面每次載入都讀 10 筆資料，一天 5000 個訪客就用完了。而且 Firebase 的計費方式是按「讀取次數」，不是按「資料量」。
更要命的是：如果你的程式碼寫得不好，一次操作可能觸發幾十次不必要的讀取。
怎麼省？
- 用
where過濾，不要讀整個 collection - 把不常變的資料快取在前端
- 讀取一次就好，不要在 useEffect 裡重複觸發
踩坑的正確態度
大多數人踩坑的反應是：「靠，又浪費時間了。」
我的反應是：「讚，又多一篇內容可以寫了。」
這不是正面思考雞湯。這是事實：
你踩過的每一個坑，都是別人願意花錢買的經驗。
- 踩過 Firebase 的坑 → 你能幫客戶避開同樣的坑
- 踩過部署的坑 → 你能寫教學文章引流
- 踩過行銷的坑 → 你能給新手真正有用的建議
而且，分享踩坑經驗是最好的內容。因為它真實、它有共鳴、它有價值。
沒有人想看「我做了一個很成功的產品」。大家想看的是「我搞砸了什麼、我怎麼修好的、你可以怎麼避開」。
給新手的踩坑生存指南
□ 改完程式碼，先 npm run dev，別直接 push
□ API Key 放 .env，.env 放 .gitignore
□ 雲端服務設定預算警報（尤其是 AI API）
□ 不要一次學所有工具，一個一個來
□ 行銷比開發早開始 — 先有人，再有產品
□ 踩坑了就記錄下來 — 這是你最好的內容
□ 錯了就錯了，重點是學到什麼
最後一件事
完美主義是一人公司最大的敵人。
你不需要等到產品完美才上線。你不需要等到文章完美才發布。你不需要等到什麼都會了才開始。
上線 → 收到回饋 → 修正 → 再上線。
這個循環越快，你進步越快。
踩坑不可怕。可怕的是你因為害怕踩坑，所以不敢開始。
這是「新手上路」系列的第三篇。上一篇：AI 提問術：為什麼你跟 AI 對話總是得不到想要的結果？
想要更多免費資源？加入一人公司實驗室 Discord。
Discord: https://discord.gg/ewS4rWXvWk