朋友看你用 AI 做了一個很酷的小工具,說:「檔案給我,我幫你加個功能。」
你把資料夾壓縮丟過去,結果他說:「跑不起來欸,一堆錯誤。」
這不是他的問題,也不是你的問題——是你們對「程式怎麼跑」的理解不一樣。
🤔 為什麼會這樣?
現代的程式開發,早就不是「一個 HTML 檔案丟到瀏覽器就能跑」的時代了。
你用 AI 做出來的專案,通常包含:
- 原始碼 — 你寫的(或 AI 幫你寫的)程式碼
- 依賴套件 — 專案用到的第三方程式庫(通常幾百 MB)
- 建構工具 — 把原始碼「編譯」成可執行版本的工具
- 執行環境 — Node.js、Python、或其他運行時
你丟給朋友的,通常只有「原始碼」。其他三樣他都沒有。
📦 舉個例子
假設你用 AI 做了一個 Vue + Vite 的網站:
你的電腦:
├── node_modules/ ← 500MB 的依賴套件(你沒傳)
├── src/ ← 原始碼(你傳了這個)
├── package.json ← 依賴清單(你傳了)
├── vite.config.js ← 建構設定(你傳了)
└── dist/ ← 建構後的成品(你可能沒傳)朋友拿到後,他需要:
- 安裝 Node.js(如果沒有的話)
- 執行
npm install下載所有依賴 - 執行
npm run dev啟動開發伺服器
如果他不知道這些步驟,就會看到一堆錯誤。
🎯 三種解決方案
方案一:給他「建構後的成品」
如果你的專案是純前端(沒有後端 API),可以先建構好再給他:
npm run build然後把 dist/ 資料夾給他,這是編譯後的靜態檔案,用任何 HTTP 伺服器都能跑。
適合:純前端網站、靜態工具
不適合:需要後端、需要資料庫的專案
方案二:寫一份說明文件
在專案根目錄加一個 README.md:
# 我的超酷專案
## 環境需求
- Node.js 18 以上
- npm 或 yarn
## 安裝步驟
1. 打開終端機,進入專案資料夾
2. 執行 `npm install`
3. 執行 `npm run dev`
4. 打開瀏覽器,輸入 http://localhost:5173
## 常見問題
- 如果出現 xxx 錯誤,請確認 Node.js 版本
- 如果 port 被佔用,改用 `npm run dev -- --port 3000`讓 AI 幫你寫這份文件,省得朋友問東問西。
方案三:直接部署上線
最省事的方法:把網站部署到網路上,給朋友網址就好。
免費選項:
- Vercel — 拖拉上傳就部署,超簡單
- Netlify — 同上,也很方便
- GitHub Pages — 如果是靜態網站
- Firebase Hosting — Google 家的,免費額度夠用
這樣朋友不用裝任何東西,打開網址就能用。
💡 什麼時候該給原始碼?
| 情境 | 建議做法 |
|---|---|
| 朋友想「用」你的工具 | 部署上線,給網址 |
| 朋友想「看」你怎麼寫的 | 給原始碼 + README |
| 朋友想「一起改」 | 用 GitHub,開共同協作 |
| 朋友是工程師 | 直接給,他會自己搞定 |
| 朋友不是工程師 | 千萬別給原始碼,他會崩潰 |
🔧 請 AI 幫你準備
下次做完專案,可以請 AI:
請幫我:
1. 寫一份 README.md,說明如何安裝和執行這個專案
2. 確認 package.json 的 scripts 有 dev 和 build 指令
3. 加上 .gitignore,排除 node_modules
4. 如果可以,幫我設定 Vercel 或 Netlify 的部署📱 特別提醒:手機 APP 更複雜
如果你用 AI 做的是手機 APP(React Native、Flutter),情況更複雜:
- iOS 需要 Mac + Xcode
- Android 需要 Android Studio
- 模擬器動輒佔用 10GB 以上
- 各種環境變數、SDK 版本問題
這種專案,真的建議直接發布到 App Store / Google Play,或用 TestFlight / Firebase App Distribution 分享測試版。
結語
Vibe Coding 讓做東西變簡單了,但「分享」這件事還是需要一點知識。
記住這個原則:
如果對方只是想用,給他網址。
如果對方想一起改,先確認他有開發環境。
不要把「在你電腦上能跑」當成「在所有電腦上都能跑」。
這不是 AI 的問題,是軟體開發本來就這樣。
下次朋友說「檔案給我」,你可以優雅地回:「我先部署好,給你網址比較快。」