說明兩種網址模式、子目錄部署與重新整理 404 的修正方式。
適用:Vue 3.5 與 Vue Router 4。先完成第 00 章環境與 第 15 章的路由骨架 ,後續範例依指定檔案替換。
切換模式
第 15 章使用 createWebHashHistory。要改為乾淨網址,在 router.js 替換 import 與 history:
import { createRouter, createWebHistory } from 'vue-router'
// 保留既有 routes 與頁面匯入
const history = createWebHistory(import.meta.env.BASE_URL)將 createRouter 的 history 欄位設為上述 history。若部署在 /demo/,Vite 設 base: '/demo/',Router 使用 BASE_URL,資源路徑與導航基底才能一致。
Nginx 部署示意
建置後把 dist 放在 /srv/www/demo/,Nginx 在對應的 server 區塊設定:
location /demo/ {
root /srv/www;
try_files $uri $uri/ /demo/index.html;
}修改前用 nginx -t 檢查,通過才 reload。以直接開啟 /demo/about、重新整理及請求 JS/CSS 檢查,應顯示關於頁且資源回應正確。API 需獨立 location,避免把 API 錯誤回成 index.html。
選擇比較
hash 的 # 後內容不送給伺服器,通常不需 fallback,適合無 rewrite 控制的靜態空間;history 有較自然的網址但需要主機配合。GitHub Pages 專案頁需額外路由策略,不能只在開發 server 成功就視為部署完成。Memory history 用於 SSR 或測試,不會自行更新瀏覽器網址。
冒險者留言
comments powered by Disqus