編輯器分類與定位
| 類別 | 代表工具 | 核心優勢 | 適用階段 |
| 本地 IDE/編輯器 | VS Code, WebStorm, Sublime, Vim | 完整工具鏈、Git、偵錯、擴充生態 | 正式開發、團隊協作 |
| 線上編輯器 | CodePen, JSFiddle, StackBlitz, CodeSandbox | 零安裝、即時預覽、分享連結、NPM 直裝 | 原型驗證、教學、面試、Issue 複現 |
| 命令列/建置工具 | Vite, Webpack, Astro, 11ty, Hugo | 自動化、最佳化、SSG/SSR、部署整合 | 專案建置、生產部署 |
VS Code 實戰操作流
1. 專案初始化
mkdir my-site && cd my-site
code .
# 建立 index.html, styles.css, app.js
2. 啟動開發伺服器 (解決 file:// 限制)
- 安裝 Live Server 擴充 → 右鍵 index.html →
Open with Live Server
- 或終端機:
npx serve / python -m http.server / php -S localhost:8000
3. Emmet 极速寫 HTML
! + Tab → 完整 HTML5 模板
header>nav>ul>li*4>a[href=#]{Item $} → 導覽結構
.card*3>img+h3+p → 三張卡片
4. 存檔自動格式化 + 驗證
// settings.json
{
"editor.formatOnSave": true,
"editor.defaultFormatter": "esbenp.prettier-vscode",
"html.validate.scripts": true,
"html.validate.styles": true
}
線上編輯器進階用法
CodePen
- Pen Settings → Add External Scripts/Styles (CDN)
- Export → Zip / GitHub Gist / CodePen Project
- Professor Mode (付費) 即時教學
StackBlitz / CodeSandbox
- 完整 Node 環境:
npm install、import 套件、Hot Module Replacement
- GitHub 整合:Import Repo / Export Repo / PR 預覽
- 支援 Next.js, Vite, Astro, SvelteKit 等框架模板
命令列建置流程 (Vite 範例)
npm create vite@latest my-app -- --template vanilla
cd my-app
npm install
npm run dev # 開發伺服器 (HMR)
npm run build # 生產建置 → dist/
npm run preview # 預覽建置產物
Vite 內建 HTML 處理:index.html 為入口,自動解析 <script type="module">、注入 HMR、資產雜湊、壓縮。
常見問題排查
| 問題 | 原因 | 解決 |
| 雙擊 HTML 無樣式/腳本錯誤 | file:// 協定限制 | 改用 Live Server / 本地 HTTP Server |
| Emmet 不展開 | 未識別語言模式 | 存檔為 .html / 右下角選 HTML |
| Prettier 格式化壞掉模板語法 | 衝突 (Jinja, Blade, Vue SFC) | 用對應 prettier-plugin 或 // prettier-ignore |
| 線上編輯器無法安裝 npm 套件 | 環境限制 | 改用 StackBlitz/CodeSandbox (完整 Node) |
團隊協作規範建議
- 統一編輯器設定:
.editorconfig + .vscode/settings.json (Commit 入 repo)
- 統一格式化:Prettier +
.prettierrc (Commit 入 repo)
- 統一驗證:HTMLHint + Stylelint + ESLint (CI 阻擋)
- Git Hooks:Husky + lint-staged (提交前自動修正)
- 元件化開發:Astro / 11ty / Vue / React / Svelte — 避免手寫重複 HTML
延伸閱讀