「你的檔案給我,我幫你改」— 為什麼 Vibe Coding 做出來的東西,朋友拿到卻跑不起來?

管管
AI 應用
團隊協作開發

朋友看你用 AI 做了一個很酷的小工具,說:「檔案給我,我幫你加個功能。」

你把資料夾壓縮丟過去,結果他說:「跑不起來欸,一堆錯誤。」

這不是他的問題,也不是你的問題——是你們對「程式怎麼跑」的理解不一樣。

🤔 為什麼會這樣?

現代的程式開發,早就不是「一個 HTML 檔案丟到瀏覽器就能跑」的時代了。

你用 AI 做出來的專案,通常包含:

  • 原始碼 — 你寫的(或 AI 幫你寫的)程式碼
  • 依賴套件 — 專案用到的第三方程式庫(通常幾百 MB)
  • 建構工具 — 把原始碼「編譯」成可執行版本的工具
  • 執行環境 — Node.js、Python、或其他運行時

你丟給朋友的,通常只有「原始碼」。其他三樣他都沒有。

📦 舉個例子

假設你用 AI 做了一個 Vue + Vite 的網站:

你的電腦:
├── node_modules/     ← 500MB 的依賴套件(你沒傳)
├── src/              ← 原始碼(你傳了這個)
├── package.json      ← 依賴清單(你傳了)
├── vite.config.js    ← 建構設定(你傳了)
└── dist/             ← 建構後的成品(你可能沒傳)

朋友拿到後,他需要:

  1. 安裝 Node.js(如果沒有的話)
  2. 執行 npm install 下載所有依賴
  3. 執行 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 的問題,是軟體開發本來就這樣。

下次朋友說「檔案給我」,你可以優雅地回:「我先部署好,給你網址比較快。」