其他平台
Netlify、Vercel、Cloudflare Pages、AWS Amplify、Render 這類平台設定幾乎相同:
| 項目 | 值 |
|---|---|
| Build command | npm run docs:build |
| Output directory | docs/.vitepress/dist |
| Node | 20 以上(正式環境請跟本機一樣用 22+) |
站點若在網域根路徑,base 用 '/'。若在 https://example.com/docs/ 這種子路徑,仍要設 base: '/docs/'。
不要開啟 HTML 自動壓縮
部分平台有 Auto Minify HTML。它可能刪掉 Vue 需要的註解,建置看起來成功,瀏覽器卻報 hydration mismatch。請關掉 HTML minify,或排除 VitePress 輸出。
快取靜態資源
assets/ 裡的 JS/CSS 檔名帶內容雜湊,同一個 URL 內容不會變。可設:
Netlify 把 _headers 放進 docs/public/;Vercel 則在 repo 根目錄放 vercel.json。範例見官方〈HTTP 緩存標頭〉。
自架 Nginx
把 dist 指到 root。try_files 不要一律退回 index.html(那是 SPA 應用的寫法);文件站應嘗試 $uri、$uri.html、$uri/,找不到再 404。否則重新整理內頁時狀態會不正確。
若開啟 cleanUrls: true,更需要這份 try_files。官方提供了含 gzip 與 /assets/ 長快取的範例 server 區塊。
其他托管
Firebase、GitLab Pages、Azure Static Web Apps、Surge、Heroku 等,官方部署頁都有對應的輸出目錄或設定檔欄位。原則相同:建置指令產出 dist,托管該資料夾,子路徑記得設 base。