iT邦幫忙

2025 iThome 鐵人賽

DAY 1
0
Modern Web

Modern Web × AI《拖延怪日記》:語錄陪伴擺脫拖延系列 第 1

macOS VS Code Modern Web JavaScript 獨立環境建置

  • 分享至 

  • xImage
  •  

摘要
這篇文章一步步教剛接觸 VS Code 與 Node.js 的初學者快速在 macOS 上建立本機網頁開發環境。先安裝 Node.js 20+ 與 VS Code,接著建立一個專案資料夾並使用 npm 初始化,再透過安裝 http-server 或 Live Server 外掛啟動本地伺服器,模擬伺服器環境,然後新增一個 index.html 測試網頁,確認能在瀏覽器成功顯示內容。
主要流程
Node.js 與 VS Code 安裝 → 建立專案 → npm 初始化 → http-server 啟動 → Live Server → 測試 index.html → 專案結構
補充
http-server 與 Live Server 可以快速展示 HTML 網頁,但若要進一步使用前端框架(例如 React、Vue、Svelte),或需要更進階的模組打包工具(像 Vite、Webpack),就需要額外學習不同的建置流程。

安裝 Node.js

  • Node.js 是 JavaScript 執行環境,可以讓你在電腦上跑伺服器、工具與套件。
  • 前往 Node.js 官網 安裝 Node.js 20+ (LTS)(目前為 v22.18.0)
  • 選擇左下角的 macOS Installer
    https://ithelp.ithome.com.tw/upload/images/20250816/20177913MvTDFKXdN5.png

安裝 VS Code

  • VS Code 是輕量級程式編輯器,支援外掛與整合終端機,適合前端開發。
  • 前往 VS Code 官網 下載並安裝 VS Code。

建立專案資料夾

在任意位置建立資料夾,例如:procrastinator-mvp,這將作為專案的根目錄。

使用 npm 啟動網頁方案(任何電腦拿到專案後都可執行)

  1. 在 VS Code 上方工具列,點選 Terminal → New Terminal。
    https://ithelp.ithome.com.tw/upload/images/20250816/20177913V9oKUHcHyJ.png

    終端機會出現在下方。
    https://ithelp.ithome.com.tw/upload/images/20250816/20177913a1mDqCUL0d.png

  2. 在終端機輸入以下指令:

# 建立一個基本的 package.json
npm init -y
  • npm (Node Package Manager):Node.js 內建的套件管理工具,可以幫你下載與管理第三方套件(例如 http-server)。
  • package.json:專案的「設定檔」,會紀錄:
    • 專案名稱、版本
    • 使用的套件清單(dependencies)
    • 啟動或編譯的腳本(scripts)
# 建立 node_modules
npm i -D http-server
  • node_modules 是 npm 安裝套件後存放的資料夾。
    • 裡面包含了你專案所需的所有外部套件(例如 http-server)。
    • 這個資料夾可能會很大,因為每個套件可能還會依賴其他套件。
    • 一般情況下,不需要手動修改 node_modules。
    • 由於檔案龐大,通常會在 .gitignore 忽略它,而只分享 package.jsonpackage-lock.json
      - 其他人只要執行 npm cinpm install,就能重新安裝相同的套件。

補充:

  • npm ci (clean install)

    • 完全依照 package-lock.json 安裝套件,忽略 package.json 的模糊範圍。
    • 在安裝前會 刪除整個 node_modules,確保環境乾淨。
    • 適合「自動化環境」:CI/CD、部署、團隊一致環境。
  • npm install

    • 會根據 package.json(和 package-lock.json 若存在)安裝套件。
    • 如果 package-lock.json 與 package.json 有差異,會更新 lock 檔(產生新的 package-lock.json)。
    • 適合「開發過程」:新增套件、更新套件。
  1. 如果左邊檔案樹出現以下內容,代表安裝成功:
    https://ithelp.ithome.com.tw/upload/images/20250816/20177913tmktlMVCix.png

  2. 修改 package.json,在 script 加入啟動腳本:

"start": "http-server -p 5173" ,

https://ithelp.ithome.com.tw/upload/images/20250816/20177913FsGUVxytU2.png

若 5173 埠口被佔用,可使用其他埠口例如 5174 。

使用 VS Code Live Server 外掛一鍵啟動你的網頁(只適用本機)

  • 在左邊工具列的 Extensions 搜尋並安裝 Live Server 外掛。
    https://ithelp.ithome.com.tw/upload/images/20250816/20177913X8WigSsMVF.png
  • 啟動方式:在 VS Code 開檔後 → 右下角「Go Live」,再按一次同位置即可關閉網頁。

新增測試網頁 index.html

在專案內新增 index.html,測試內容如下:

<!DOCTYPE html>
<html lang="zh-Hant">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>拖延怪日記 MVP</title>
</head>
<body>
  <h1>哈囉!這是拖延怪日記 MVP</h1>
  <p>如果你看到這行文字,代表伺服器跑成功</p>
</body>
</html>
記得按 Ctrl + S 儲存所有檔案,不然網頁會呈現空白。

啟動專案測試

  • 本機:
npm run start
  • 已取得專案的其他電腦:
npm ci && npm run start 
  • 打開瀏覽器 → http://localhost:5173 ,看到 「哈囉!這是拖延怪日記 MVP」 代表成功。

專案結構範例

procrastinator-mvp/
├─ package.json
├─ package-lock.json
├─ node_modules/
└─ index.html


下一篇
【Day 2】- macOS 使用 Node.js 終端安裝 Gemini CLI 並連動 VS Code
系列文
Modern Web × AI《拖延怪日記》:語錄陪伴擺脫拖延19
圖片
  熱門推薦
圖片
{{ item.channelVendor }} | {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言