壓縮檔幾百 MB、上傳又說缺檔？專案打包前的五項檢查
一個很常見的下午：檔案傳不出去，或傳出去了卻被退回
行銷主管把工程師留下的專案資料夾整個右鍵壓縮，跑了十分鐘，出來是 1.3 GB。LINE 傳不了，信箱附不了，好不容易放上雲端，對方回一句：「少了 package.json，我們沒辦法跑。」
這兩種狀況方向相反，原因卻常出在同一件事：不知道哪些檔案該進壓縮檔，哪些不該。 您能把專案整包找出來並想把它送出去，已經完成最難的第一步。下面是實務上可以照著做的判斷方式。
五類檔案，各自該不該放進去
| 項目 | 建議 | 原因 |
|---|---|---|
node_modules/ | 不放 | 通常是體積最大的來源，可以由 package.json 重新安裝出來 |
.git/ | 看用途 | 只是要預覽網站就不必；要交接給接手工程師，保留才看得到修改歷史 |
.env 及金鑰檔 | 不放 | 裡面常有 API 金鑰與資料庫密碼，放進去等於一起送出 |
build 輸出（dist/、build/、.next/） | 擇一 | 看您要送的是原始碼，還是已經做好的成品（見下方說明） |
lock 檔（package-lock.json、pnpm-lock.yaml、yarn.lock） | 要放 | 記錄每個套件的確切版本，缺了它，別人安裝時可能拿到不同版本而出錯 |
「缺檔」最常見的三個原因
- 把 lock 檔或 package.json 一起排除了。 想瘦身時手滑，把「看起來不重要」的設定檔刪掉。這兩類檔案體積很小，請務必保留。
- 只壓縮了部分資料夾。 例如只選了
src/，漏掉外層的設定檔與public/。 - 多包了一層資料夾。 解壓縮後是「專案名稱/專案名稱/…」，工具找不到根目錄的 package.json 或 index.html。建議打開壓縮檔確認：一進去就能看到這些檔案。
另外，Mac 壓縮常會夾帶 __MACOSX 與 .DS_Store，Windows 則可能帶入縮圖檔，這些不影響內容，但可以順手清掉。
build 輸出：要送原始碼，還是成品？
- 送原始碼（含 package.json、lock 檔、
src/、public/）：對方要能自己建置。這是交接給工程師時最完整的做法。 - 送成品：如果是純 HTML / CSS / JS 的網站，或您已經建置好、資料夾裡有
index.html的靜態成品，可以直接打包。注意要把資料夾「裡面的內容」壓縮，而不是外面再包一層。
兩者不要混著放。原始碼加上一份過期的 dist/，反而容易讓人搞不清楚哪個才是最新版。
打包前五分鐘檢查清單，以及用 /launch/ 當驗證關卡
建議照這個順序做：
- 刪掉或排除
node_modules/、.git/（預覽用途時）、.DS_Store、__MACOSX。 - 確認沒有
.env、.pem、serviceAccount.json這類含密碼的檔案。如果不確定自己有沒有漏，可以參考 壓縮檔準備傳給廠商前的金鑰檢查；若真的需要提供設定值，請另外用安全的方式交給對方，並附上一份只有欄位名稱、沒有內容的範例檔。 - 確認 package.json 與 lock 檔都在根目錄。
- 打開壓縮檔，第一層就能看到專案檔案，沒有多包一層。
- 看一下大小。排除 node_modules 之後，多數網站專案會小很多；如果還是很大，通常是未壓縮的圖片、影片或備份檔，可以先移到別處。
用 /launch/ 實際跑一次
不確定打包得對不對，最直接的方法是真的上傳試一次。在 /launch/ 您可以：
- 上傳 ZIP（最大 200 MB），或只有一個 HTML 檔（ChatGPT、Claude 常直接給這種）。自己決定子網域名稱。
- 系統會檢查檔案、解壓縮、判斷專案類型並建置；每個步驟都看得到進度，也能打開建置紀錄。如果缺檔，建置紀錄是第一個要看的地方，可以參考 怎麼讀建置紀錄裡的錯誤。
- 成功後會得到
名稱.aionline.tw的公開網址，可以傳給客戶或主管。免費 7 天，不需要信用卡，也不會自動扣款，到期就下線。 - 之後想換新版本，上傳後要用寄到信箱的驗證碼確認；新版本建置完成前，舊版繼續在線上，更新失敗也會保留舊版。
它不處理的部分
免費預覽只能放靜態檔案：HTML / CSS / JS，或建置後會產生靜態檔案的前端專案（例如許多 Lovable、v0、Cursor 做出來的專案）。如果您的專案需要常駐的後端或資料庫，系統不會硬部署，而是提供一份 AI 健診報告，說明原因。這時下一步可以考慮把專案連同這份報告交給工程師評估，或是直接聯絡我們，範圍與費用都會先以書面談定。
下一步： 先照上面清單把專案整理一次，再到 /launch/ 上傳 ZIP 做免費預覽。能跑起來，代表您的打包方式是正確的；跑不起來，建置紀錄也會告訴您缺的是什麼。
關於 AI 上線專家
AI 上線專家讓您的 AI 幫您把網站部署上線：把一句話貼給 Claude Code、Cursor 或 Codex，幾分鐘後就有一個 您的名稱.aionline.tw 公開網址，可以直接傳給客戶或同事看。
- 免費預覽，不需信用卡，到期自動下線、不會扣款；滿意再升級為永久，最低 NT$99 / 月起
- 靜態網站、Node／Python 等有後端的網站都能部署，需要資料庫時自動配好 Postgres
- 付費方案可以綁自己的網域；部署不起來或需要客製開發，可以直接聯絡我們