在自己的電腦開啟 HTTP 預覽
第16堂的草稿練習統一使用本機 HTTP。這是自己的練習預覽,不是公開發布;第1–15堂能正常直接開檔時仍可沿用原方式。
1.先確認 Node.js
在 Cursor 選單開啟「終端機/Terminal → 新增終端機/New Terminal」,輸入:
node --version
看到 v22 或以上可繼續。若顯示找不到命令,先到 Node.js 官方下載選擇自己系統的 LTS 安裝程式:Windows 使用 .msi、macOS 使用 .pkg。安裝後關閉並重開 Cursor,再執行相同命令。不要只因終端顯示錯誤就貼入來路不明的安裝指令。
2.下載工具與整理位置
下載本機預覽工具,解壓後將 preview-tools 放進自己的 student-work。工具不需 npm install、不會修改網站,不需要提供帳密。
student-work/
├── preview-tools/
│ ├── preview.mjs
│ └── START_PREVIEW.html
├── service-site/
│ └── frontend/
│ ├── index.html
│ └── inquiry.html
└── fault-L16/
└── service-site/
└── frontend/
├── inquiry.html
└── draft-test.html
用 Cursor「開啟資料夾」選 student-work,再新增終端機;終端提示的位置應是 student-work。先核對目錄名稱;若資料夾名稱與圖不同,指令的 --root 要改成自己實際的位置。含空白的路徑用雙引號包住。以下命令在 macOS/Linux 與 Windows PowerShell 相同。
3.啟動正常表單
node preview-tools/preview.mjs --root service-site/frontend --port 8791
保持這個終端開啟。看到預覽網址後,在瀏覽器開 http://127.0.0.1:8791/inquiry.html。若自己的正常作品在 L16/service-site/frontend,改用 --root L16/service-site/frontend;不要移走原資料。
4.另開故障練習
下載第16堂故障包,整個 service-site 放入 fault-L16。在 Cursor 另開第二個終端,仍從 student-work 執行:
node preview-tools/preview.mjs --root fault-L16/service-site/frontend --port 8792
開 http://127.0.0.1:8792/draft-test.html 放入虛構資料,再按頁面中的連結去故障表單。故障表單及資料測試頁使用專屬 qinghe.inquiryDraft.faultL16.v1,不會改正常表單的 qinghe.inquiryDraft.v1;不同埠也分開瀏覽器來源。請一直用同一個故障網址測試,避免把 127.0.0.1 換成 localhost 造成看不到原測試草稿。
5.檢查與停止
- 正常表單存一份虛構草稿A;在故障頁放壞JSON;回正常頁按還原,仍應得到A。
- 儲存HTML/CSS/JS後重整對應網址;重新整理不會自動重建程式。
- 網址404:核對 --root 指向含 inquiry.html 的 frontend,不是外層 service-site。工具不會列出整個資料夾內容。
- 埠被占用:回該工具的終端按 Ctrl+C,再重新啟動。不要關掉不認識的服務。
- 做完後在兩個預覽終端各按 Ctrl+C;只停止工具,檔案與草稿不會被刪除。
第17堂起改用提供的 Node 教學後端(預設8780),不用這個靜態工具取代API。8791/8792是本堂操作位置,不需要購買主機或上傳到網路。