Skip to content

建立 2026-09-15 更新 2026-09-15

其他平台

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 內容不會變。可設:

Cache-Control: max-age=31536000, immutable

Netlify 把 _headers 放進 docs/public/;Vercel 則在 repo 根目錄放 vercel.json。範例見官方〈HTTP 緩存標頭〉。

自架 Nginx

dist 指到 roottry_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