無建構工具宣言:不用打包工具直接發布

以下並非要您放棄建構工具的論述,而是對放棄後實際結果的測量。

blakecrosley.com 運行 FastAPI + Jinja2 + HTMX + Alpine.js + 純 CSS。沒有 webpack、沒有 Vite、沒有 Rollup、沒有 TypeScript 編譯器、沒有 Babel、沒有 PostCSS、沒有 Tailwind、沒有 package.json、沒有 node_modules/。網站提供 37 篇部落格文章(含 20 個互動式 JavaScript 元件)、20 份指南、十種語言翻譯,並在 Lighthouse 上取得 100/100/100/100 的滿分。這個 Lighthouse 分數您可以親自驗證:在任何頁面上執行 PageSpeed Insights 即可。11

摘要

HTMX 社群不缺倡導,缺的是證據。這裡的數據來自一個具備大量內容、互動功能和國際化支援的生產環境網站,而且完全沒有使用任何建構工具。取捨是誠實的,結論也是限縮的:對於內容導向、由個人開發者或小團隊維護的網站,建構工具解決的是您沒有的問題,同時製造了您確實會有的問題。對於擁有共用元件庫和設計系統套件的大型團隊,建構工具的複雜性是值得的。這條界線比社群討論中暗示的更加清晰。


技術堆疊

Backend:    FastAPI + Jinja2 (server-rendered HTML)
Frontend:   HTMX + Alpine.js + Bootstrap 5 (CDN)
Styles:     Plain CSS with custom properties
JavaScript: Vanilla JS, IIFE-scoped per component
Deployment: Railway (git push → live)
CDN:        Cloudflare (caching, Workers, D1)

沒有轉譯、沒有 tree shaking、沒有熱模組替換、沒有 source maps。您寫的 JavaScript 就是最終交付的 JavaScript。


實際數據

以下是真實指標,不是估算:

指標 blakecrosley.com 典型 Next.js 專案(作者估計)1
相依套件 15 個 Python 套件 311 個 npm 套件(已驗證:npx create-next-app@latest,2026 年 2 月)1
建構設定檔 0 5-8 個(next.config、tsconfig、postcss、tailwind、eslint、babel 等)
node_modules/ 大小 不存在 基準 187 MB(已驗證),加上其他套件後為 250-400 MB1
安裝時間 pip install -r requirements.txt:8 秒 npm install:30-90 秒
建構步驟 無 next build:15-60 秒
部署流程 git push → 約 40 秒上線 git push → 安裝 → 建構 → 部署:2-5 分鐘
CSS 檔案 17 個檔案,10,846 行(純 CSS) 由 Tailwind/Sass 產生,輸出量不定
JS 檔案 33 個檔案,8,819 行(人類可讀) 打包、壓縮、分塊:生產環境中不可讀
Lighthouse 效能 100 未經明確最佳化時為 70-90(依據 Vercel 自身的效能文件)13

這 15 個 Python 套件包含 FastAPI、Jinja2、Pydantic 及其他 12 個。沒有任何一個是建構工具,沒有任何一個是編譯器,也沒有任何一個是打包工具。2


您放棄了什麼

誠實要求列出真實的代價,而它們確實存在。

沒有 TypeScript。 這個專案中的每個 .js 檔案都是原生 JavaScript。負責捕捉型別錯誤的是測試和 Claude Code 的分析,而非編譯器。這種做法對個人開發者有效,但對於 10 人團隊在模組間共用元件介面的情境則行不通。

沒有熱模組替換。 修改 CSS 檔案後,我手動重新整理瀏覽器。HTMX 的 hx-boost 只透過 AJAX 擷取 body 內容並直接替換,不必重新載入整個頁面,因此導航夠快,全頁重新整理也還能忍受。若是在每 30 秒就要迭代一次視覺細節的專案中,HMR 確實能省下可觀的時間。

沒有 Tree Shaking。 我寫的每一個位元組的 JavaScript 都會送到瀏覽器。我無法從工具函式庫中只匯入單一函式,而不送出整個檔案。Tree shaking(由打包工具消除無用程式碼:追蹤匯入路徑,移除沒有任何模組引用的函式)按定義就需要建構步驟。這個限制迫使人養成紀律:用小而專注的檔案取代大型工具模組。20 個互動元件平均各 130-450 行,因為它們必須自給自足。3

沒有來自 npm 的元件庫。 沒有 Radix、沒有 shadcn/ui、沒有 Headless UI。每個互動元素(Boids 模擬、漢明碼視覺化器、共識模擬器)都是手工打造的。這種做法之所以可行,是因為互動元件服務於特定的教學目的,而非通用的 UI 模式。

沒有來自 npm 的設計系統 Token。 我的設計系統完全存在於 CSS 自訂屬性中,無法作為套件匯入其他專案。對單一網站的系統而言,這個限制可以接受;對多產品組織來說則不然。

這五項取捨對於由單一開發者維護的內容導向網站是可以接受的,對於擁有 15 人工程團隊的 SaaS 產品則無法接受。


您獲得了什麼

零建構失敗。 部署流程就是 git push。不會有 npm install 因 peer dependency 衝突而失敗,不會有 next build 因某個我沒碰過的檔案中的 TypeScript 錯誤而失敗,也不會有 Dependabot PR 升級某個間接相依套件後破壞建構。4

用「檢視原始碼」來除錯。 在瀏覽器中執行的 JavaScript 就是我寫的 JavaScript。不需要 source maps,不需要從編譯輸出反向對應到原始碼。生產環境出現 bug 時,我直接閱讀部署出去的檔案。

瞬間本地啟動。 uvicorn app.main:app --reload 在 2 秒內啟動。不需要先安裝、編譯、打包才能看到頁面的 npm run dev。

具體的請求瀑布。 首次造訪一篇部落格文章時會載入:一份 HTML 文件(gzip 後約 15KB)、一個 CSS 檔案(約 8KB)、一個頁面專屬 CSS 檔案(約 2KB)、來自 CDN 的 HTMX(約 14KB,可快取)、來自 CDN 的 Alpine.js(約 14KB,可快取),以及該頁面的互動式 JS 元件(約 4-8KB)。總傳輸量:首次造訪 45-60KB,快取後 15-25KB。沒有 bundle 分割、沒有 chunk 協商、沒有執行期模組解析。瀏覽器只請求頁面需要的內容,別無其他。

零 Dependabot 噪音。 沒有 package-lock.json,就沒有每週更新 semver、ansi-regex 或 glob-parent 的 PR。這些套件我從未直接匯入,卻深藏在相依樹三層之下。

面向未來的前端。 客戶端程式碼 10 年後仍能運作。HTML 就是 HTML,CSS 就是 CSS,JavaScript 就是 JavaScript。沒有 Webpack 4 → 5 遷移,沒有 Create React App 棄用,沒有 Next.js App Router 遷移。平台本身就是標準。5 至於伺服器端的相依套件(FastAPI、Python、Railway),仍然需要版本管理和偶爾的更新:無建構工具的做法消除的是前端工具鏈的變動,而非後端維護。


HTMX 作為架構

HTMX 的討論焦點集中在語法:hx-get、hx-swap、hx-target。這是錯誤的視角。架構上的洞見在於伺服器渲染的 HTML 本身就是 API。

在傳統 SPA 中:

Browser → fetch('/api/users') → JSON → React renders HTML → DOM update

使用 HTMX:

Browser → GET /users (hx-get) → Server renders HTML fragment → DOM swap

伺服器回傳的是最終呈現。沒有客戶端狀態管理、沒有序列化/反序列化、沒有 hydration。Jinja2 模板就是元件,FastAPI 端點就是 API。一層,而非三層。6

架構上的影響層層擴散。以下三項消除,每一項移除的都是一整類問題,而非單一 bug。

沒有 JSON 邊界。 回應結構不符、null 與 undefined 的歧義、日期序列化不一致,這些都隨之消失。TypeScript 和 Zod 的存在就是為了防範這類 bug;HTMX 則改為回傳 HTML 而非 JSON,從根本上消除了這整類問題。

沒有客戶端狀態管理。 讓伺服器狀態與客戶端狀態保持一致,是 SPA 開發中最困難的部分。HTMX 只保留一個唯一的事實來源:伺服器,問題也就不復存在。

沒有 hydration。 頁面先渲染伺服器的 HTML,接著 JavaScript 框架在客戶端重新渲染而造成閃爍,這種「恐怖谷」並不存在。伺服器的 HTML 就是最終輸出。

具體比較最能顯示差異。以下是用兩種方式打造的即時搜尋輸入框:

使用 React + 建構工具(JSX,需要轉譯):

// SearchBox.jsx — requires Babel, bundler, npm install
import { useState, useEffect } from 'react';
export default function SearchBox() {
  const [query, setQuery] = useState('');
  const [results, setResults] = useState([]);
  useEffect(() => {
    if (!query) return setResults([]);
    fetch(`/api/search?q=${query}`).then(r => r.json()).then(setResults);
  }, [query]);
  return (<div>
    <input value={query} onChange={e => setQuery(e.target.value)} />
    <ul>{results.map(r => <li key={r.id}>{r.title}</li>)}</ul>
  </div>);
}

使用 HTMX + 伺服器渲染(純 HTML,無建構步驟):

<!-- search.html — ships as-is, no transpilation -->
<input type="search" name="q"
       hx-get="/search" hx-trigger="keyup changed delay:300ms"
       hx-target="#results" />
<ul id="results"></ul>
# server — returns rendered HTML, not JSON
@router.get("/search")
async def search(q: str = ""):
    results = await db.search(q)
    return templates.TemplateResponse("partials/results.html",
        {"results": results})

HTMX 版本沒有客戶端狀態、沒有序列化邊界,也沒有建構步驟。伺服器回傳最終的 HTML,瀏覽器將它替換進去。整個互動只需八行模板和五行 Python。

這種模式直接對應複合工程原則:每一塊基礎設施只做一件事,各部分組合時互不干擾。模板渲染 HTML,路由回傳它,HTMX 將它替換進頁面。不需要建構步驟來協調這些部分,因為根本不需要協調。

更複雜的範例:具備驗證的多步驟表單

即時搜尋是 HTMX 的經典示範。多步驟表單則能展示這個模式在生產環境複雜度下的樣貌:伺服器端驗證、有條件的步驟推進,以及在不使用客戶端狀態管理的前提下跨請求保留狀態:

<!-- step1.html — first form step -->
<form id="signup-form" hx-post="/signup/step1" hx-target="#signup-form" hx-swap="outerHTML">
  <input type="email" name="email" required />
  <button type="submit">Next</button>
</form>
# server — validates step 1, returns step 2 or errors
@router.post("/signup/step1")
async def signup_step1(request: Request, email: str = Form(...)):
    if not validate_email(email):
        return templates.TemplateResponse("partials/step1.html",
            {"error": "Invalid email format", "email": email})
    # Store progress server-side (session, DB, or signed cookie)
    request.session["signup_email"] = email
    return templates.TemplateResponse("partials/step2.html",
        {"email": email})
<!-- step2.html — second step, rendered by server only after step 1 validates -->
<form id="signup-form" hx-post="/signup/step2" hx-target="#signup-form" hx-swap="outerHTML">
  <p>Email: {{ email }}</p>
  <input type="text" name="name" required />
  <input type="password" name="password" minlength="8" required />
  <button type="submit">Create Account</button>
</form>

表單狀態由伺服器掌握。步驟 2 只有在步驟 1 通過伺服器端驗證後才會渲染:沒有客戶端條件渲染,沒有表單狀態函式庫,也沒有 useReducer。驗證錯誤時,目前的步驟會被替換成附帶錯誤訊息的同一步驟。整個多步驟流程使用的客戶端 JavaScript 為零。若以 React 實作同樣的流程,需要為每個欄位使用 useState、一個步驟計數器、條件渲染邏輯、客戶端驗證(重複伺服器端的驗證),以及一道 API 序列化邊界。HTMX 版本把狀態留在驗證邏輯原本所在之處,也就是伺服器上,從而消除了這五項考量。


純 CSS 就夠了

我的設計系統使用 10 個顏色 token、13 個字體大小層級和 8 個間距值,全部都是 CSS 自訂屬性:

:root {
  --color-bg-dark:        #000000;
  --color-text-primary:   #ffffff;
  --color-text-secondary: rgba(255,255,255,0.65);
  --spacing-sm:           1rem;
  --spacing-md:           1.5rem;
  --font-size-lg:         1.25rem;
}

沒有 Sass 編譯步驟,沒有 Tailwind 設定檔產生工具類別,沒有 PostCSS 外掛程式轉換自訂語法。瀏覽器直接讀取這些值。CSS 自訂屬性具備前處理器變數所缺乏的能力:它們會沿著 DOM 層疊、從父元素繼承,並且可以在執行期於媒體查詢中覆寫或限定在個別元件的範圍內。Sass 變數編譯成靜態值後便消失;自訂屬性則始終保持活性,因此只要切換一次主題或深色模式,所有衍生值都會隨之改變,無須重新編譯。7

這個網站的美學與粗獷主義風格(純黑底上的白字,搭配四階不透明度)正是從限制中產生的。當您無法使用色彩調色盤時,字體排版承擔起層級。當您無法使用元件陰影時,留白創造結構。限制本身就是設計。8


CLS 之旅

Lighthouse 之旅揭露了無建構工具的一個真實代價:關鍵 CSS 擷取需要一個自訂 Python 腳本。在 Next.js 專案中,框架會自動處理這件事。

具體的問題:一個行動裝置媒體查詢覆寫了 CSS 自訂屬性(--gutter: 48px → --gutter: 24px)。關鍵 CSS 包含了桌面版的值,卻沒有包含行動裝置的覆寫。在行動裝置上,主視覺區域先以 48px 內距渲染,待完整樣式表載入後再切換為 24px,產生了 0.493 的 CLS。

修復方式是 12 行 Python,擷取包含媒體查詢覆寫在內的關鍵 CSS:

# critical_css.py — extract CSS rules matching critical selectors
# including @media overrides for mobile-first responsive values
import re

def extract_critical(css_text, selectors):
    rules = []
    for sel in selectors:
        # Match both direct rules and media-wrapped rules
        pattern = rf'{re.escape(sel)}\s*\{{[^}}]+\}}'
        rules.extend(re.findall(pattern, css_text))
    # Also extract @media blocks containing critical selectors
    media_blocks = re.findall(r'@media[^{]+\{([^}]+\{[^}]+\}[\s]*)+\}', css_text)
    for block in media_blocks:
        if any(sel in block for sel in selectors):
            rules.append(block)
    return '\n'.join(rules)

調查花了三小時,修復本身只花了 20 分鐘。建構工具本可以自動處理這個問題。

誠實的核算:建構工具自動化的是您可以手動完成的事情,但手動版本出問題時要付出除錯時間。問題在於自動化的成本(複雜性、相依套件、建構失敗、遷移變動)是否超過手動的成本(偶爾的除錯時段)。

對這個網站而言,手動成本一直較低。三年間,一個 CLS bug,三小時的除錯。10另一種選擇(維護建構流水線)在相依套件更新、破壞性變更和設定維護上會消耗更多累積時間。


何時不該採用此方法

無建構工具的做法在以下情境是錯誤的:

大型團隊。 TypeScript 的價值隨團隊規模而擴大。9當 10 位開發者共用元件介面時,編譯時期型別檢查可以防止那些執行時期測試發現得太遲的整合錯誤。個人開發者能在腦中掌握整個系統,團隊做不到。

設計系統套件。 如果多個產品使用您的設計系統,它就需要是一個具備適當版本控制、tree shaking 和建構流水線的 npm 套件。單一樣式表中的 CSS 自訂屬性無法跨儲存庫組合使用。

複雜的客戶端狀態。 如果您的應用程式具有豐富的客戶端狀態(拖放介面、即時協作、離線優先資料),React 或 Svelte 等框架的複雜性是值得的。HTMX 以伺服器往返取代客戶端狀態,在延遲成為問題之前都行得通。

npm 生態系統函式庫。 如果您需要 Radix 基本元件、Framer Motion 或 TanStack Query,就需要建構流水線。這三者都假設有打包工具存在。沒有打包工具卻要使用它們,從痛苦到不可能都有。

界線比社群討論中暗示的更簡單:如果您的應用程式主要是由伺服器渲染的內容,建構工具就是額外負擔;如果您的應用程式主要是由客戶端管理的狀態,建構工具就是基礎設施。

決策框架:您需要建構工具嗎?

請回答以下四個問題:

  1. 是否有超過五位開發者共用 JavaScript 介面? 如果是,TypeScript 的編譯時期型別檢查可以防止那些執行時期測試發現得太遲的整合錯誤。請加入建構步驟。

  2. 您的應用程式是否管理複雜的客戶端狀態? 如果拖放、即時協作或離線優先資料是核心功能(而非錦上添花),React 或 Svelte 等框架的複雜性是值得的。請加入建構步驟。

  3. 是否有多個產品使用同一套共用元件庫? 如果是,該元件庫需要 npm 封裝、語意化版本控制和 tree shaking。請加入建構步驟。

  4. 您是否依賴假設有打包工具存在的 npm 生態系統函式庫? 如果 Radix、Framer Motion、TanStack Query 或類似的函式庫是產品的核心,建構流水線就是必要的。

如果四個答案都是「否」,無建構工具的做法就可行。只要有任何一個答案是「是」,建構工具就是在解決您確實存在的問題。錯誤在於四個答案都是「否」時仍加入建構工具:解決您沒有的問題,同時製造您確實會承受的相依套件管理負擔。

練習:稽核您目前的專案。 執行 du -sh node_modules/(或同等指令)和 wc -l package-lock.json,記下這兩個數字。接著列出建構流水線中直接服務使用者(而非開發者體驗)的三項功能。如果您舉不出三項,這條流水線服務工具鏈的程度可能多過服務產品。這些數字本身並非壞事,它們是對複雜性的測量,而複雜性應當證明自己的價值。


重點總結

對於個人開發者和小型團隊:

  • 證據是網站本身,不是論述。 blakecrosley.com 以零建構工具和完美 Lighthouse 分數提供 37 篇文章、20 個互動元件、20 份指南和十種語言。這些數據可供驗證。

  • 無建構工具的真實代價是偶爾的除錯。 CLS bug 花了三小時修復,建構工具本可以自動處理。三年來,累積的除錯時間遠低於建構流水線所需的累積維護時間。

  • 限制造就設計。 沒有顏色迫使字體排版承擔層級。沒有建構工具迫使 JavaScript 保持簡單且自給自足。最好的限制,是您在需要之前就主動選擇的限制。

對於評估技術堆疊的團隊主管:

  • 建構工具解決的是團隊規模的問題。 TypeScript、tree shaking 和元件庫在多位開發者共用介面時才值得其複雜性。打造內容導向網站的個人開發者並沒有這些問題。

  • HTMX 的真正貢獻在於架構。 以伺服器渲染的 HTML 作為 API,消除了客戶端狀態管理、序列化和 hydration。語法是次要的,洞見才是重點。


常見問題

HTMX 是否已足以用於真實 Web 應用程式的生產環境?

是的。HTMX 自 2020 年起便已穩定,並被多個產業的公司用於生產環境。創造者 Carson Gross 將向後相容性視為核心設計原則,HTMX 文件也明確表示:「htmx 遵循語意化版本控制,在同一個主要版本內不會破壞既有的應用程式。」14函式庫本身經壓縮並 gzip 後僅 14KB,零相依套件,並遵循語意化版本控制。blakecrosley.com 已在生產環境中執行 HTMX 三年,與 HTMX 相關的 bug 為零:遇到的每個問題都出在應用程式邏輯,而非函式庫本身。

不使用建構步驟,可以使用 TypeScript 嗎?

部分可以。TypeScript 檔案可以用 tsc --noEmit 進行型別檢查而不產生輸出檔案,讓編譯時期型別檢查扮演 linter 而非轉譯器的角色。然而,瀏覽器無法直接執行 .ts 檔案,因此要將 TypeScript 交付給瀏覽器仍需要建構步驟。另一個選擇是在純 .js 檔案中使用 JSDoc 型別註解,TypeScript 無須編譯即可檢查。這種做法在開發期間提供型別安全,交付的則是標準 JavaScript。

這種做法與 Astro 或 11ty 相比如何?

Astro 和 11ty 位於中間地帶:它們是靜態網站產生器,產出的純 HTML 只含極少甚至完全沒有客戶端 JavaScript,但仍需要建構步驟(Node.js、npm install、建構指令)。無建構工具的做法則完全消除了這個建構步驟,由伺服器在每次請求時渲染 HTML。取捨在於:Astro 和 11ty 產出的靜態頁面更快(不需伺服器運算),而 FastAPI + HTMX 能原生處理動態內容(使用者專屬資料、表單提交、即時更新),無須 API 層。

Web 開發團隊能否不用建構工具和 npm 就完成交付?

取決於團隊要打造的是什麼。對於內容導向網站和內部工具,2-5 人的團隊已經成功地在不使用建構工具的情況下,以伺服器渲染的 HTML 和純 CSS 完成交付。最先造成困擾的限制是共用元件介面:沒有 TypeScript,兩位開發者可能對某個函式預期的輸入有不同理解,而沒有編譯器替他們抓出來。實務上的界線大約落在 5-8 位開發者共同開發共用 JavaScript 時。超過這個規模,TypeScript 和元件庫的複雜性便值得了。


JavaScript 相依套件的成本並非本文作者獨有的觀察。Potvin, R. 與 Levenberg, J.(2016)的〈Why Google Stores Billions of Lines of Code in a Single Repository〉記錄了大規模相依套件管理的組織成本。12在個別專案層級,npm 生態系統的相依深度所帶來的,正是本文描述的維護負擔:開發者從未選擇的間接相依套件,製造出開發者必須自行管理的更新壓力。

本文橫跨部落格的設計與工程分類。設計決策見美學與粗獷主義、新創公司的設計系統和字體大小系統。工程測量數據見 Lighthouse 滿分和複合工程。Vibe Coding 一文探討了這套理念在 AI 輔助開發中的適用之處。



  1. 「典型 Next.js 專案」欄位反映了作者在 5 個以上 Next.js 專案(2021-2024)中的經驗及社群報告的常態。作為參考:全新執行 npx create-next-app@latest(Next.js 15,2026 年 2 月測試)會在 node_modules/ 中安裝 311 個套件,總計 187 MB。表格中的 311 個套件和 187 MB 就是這個實測基準;加入更多相依套件的生產專案往往更高,表格中 250-400 MB 的範圍正是由此而來。個別專案差異顯著。 ↩↩↩

  2. 截至 2026 年 2 月的完整相依套件列表:fastapi、uvicorn、starlette、pydantic、pydantic-settings、jinja2、markdown、pygments、beautifulsoup4、lxml、nh3、resend、python-multipart、httpx、analytics-941。零個是建構工具,零個是編譯器,零個是打包工具。 ↩

  3. 平均元件大小(130-450 行)來自截至 2026 年 2 月 /static/js/ 中 20 個互動式 JS 檔案的測量。大小範圍從 132 行(compound-interest-mind.js)到 450 行(subtraction-machine.js),arcade.js 以 1,666 行為例外值。 ↩

  4. 根據作者維護 Next.js 專案的經驗,JavaScript 生態系統每月為活躍專案產生 15-25 個 Dependabot PR,其中大多數更新的是開發者從未直接匯入的間接相依套件。此數字為直接觀察的估計,並非獨立驗證的基準測試。 ↩

  5. 網路平台(HTML、CSS、JavaScript)已維持 30 年的向後相容性。1996 年的頁面在 2026 年的 Chrome 中仍能渲染。Tim Berners-Lee 將此闡述為一項設計原則:”a browser should be backwards-compatible, in that it should be able to read an earlier version of the language.” 參見 w3.org/DesignIssues/Principles。 ↩

  6. HTMX 的創造者 Carson Gross 將此描述為 “hypermedia as the engine of application state”(HATEOAS)。參見 htmx.org essays 以及 Gross、Stepinski 和 Cotter 合著的 Hypermedia Systems(2023)一書:hypermedia.systems。 ↩

  7. CSS Custom Properties(CSS 變數)在全球 97% 以上的瀏覽器中受到支援。來源:caniuse.com/css-variables。使用它們不需要任何編譯步驟。 ↩

  8. 「限制作為設計工具」的原則由來已久。Charles Eames 曾說:”Design depends largely on constraints.” 電影界的 Dogme 95 運動證明了移除工具(不使用人工照明、不做後期製作)產生的是更誠實的敘事,而非更不誠實的敘事。參見 en.wikipedia.org/wiki/Dogme_95。 ↩

  9. 2024 年 Stack Overflow 開發者調查發現,TypeScript 名列最常使用的五大程式語言之一,也是採用最廣的 JavaScript 超集。調查方法與完整結果見 survey.stackoverflow.co/2024/。TypeScript 採用率與團隊規模相關的觀察,是作者根據業界實務所做的推論,並非調查的直接發現。 ↩

  10. 本網站的 git 歷史始於 2023 年 3 月。「三年」指的是從首次部署於 Railway(2023 年 3 月)到 2026 年 2 月的期間。「CLS 之旅」一節記錄的 CLS bug,是此期間唯一影響生產環境的 CSS 問題。 ↩

  11. Google PageSpeed Insights(pagespeed.web.dev)可對任何公開 URL 執行 Lighthouse 稽核,以 0-100 分評量效能、無障礙、最佳做法與 SEO。截至 2026 年 2 月,blakecrosley.com 在四個類別皆為 100 分。結果可公開驗證,並非自行申報。 ↩

  12. Potvin, R. and Levenberg, J. (2016). “Why Google Stores Billions of Lines of Code in a Single Repository.” Communications of the ACM, 59(7), 78-87. doi.org/10.1145/2854146。Google 採用 monorepo 的部分動機,在於跨數千個專案管理相依版本的組織成本,而這正是在個別專案層級造成 node_modules/ 膨脹的同一股力量。該論文記錄了相依套件管理所耗費的工程時間,與間接相依套件的數量成正比,而非與直接相依套件的數量成正比。 ↩

  13. Vercel 的 Next.js 效能文件承認,預設的 Lighthouse 分數因應用程式複雜度而異,並建議採取特定最佳化(圖片最佳化、字型載入、程式碼分割設定)以達到 90 分以上。參見 nextjs.org/docs/app/building-your-application/optimizing。70-90 的區間反映的是套用這些最佳化之前、採用預設設定的全新 create-next-app 專案,與 Next.js GitHub 討論區中社群回報的基準測試一致。 ↩

  14. HTMX 的版本政策與向後相容承諾記載於 htmx.org/migration-guide-htmx-1/。從 1.x 到 2.x 的遷移指南展現了該專案的做法:破壞性變更僅限於主要版本,有清楚的文件說明,並附帶遷移工具。Carson Gross 已在多場研討會演講及 Hypermedia Systems(2023)中闡述這項向後相容原則。 ↩

相關文章

信號評分管線:確定性知識分類法

一個733行的Python管線,從四個維度為筆記評分,並將7,700多個項目進行確定性路由。演算法、權重,以及誠實的結果。

14 分鐘閱讀

從76到100:達成完美的Lighthouse分數

一個個人作品集網站如何從行動裝置Lighthouse效能分數76分、CLS 0.493,進步到全類別完美的100/100/100/100。

6 分鐘閱讀

錯誤資料庫決策的15倍代價:決策時機的教訓

我在三個系統中衡量了資料庫決策的成本。遷移成本在三年內增長了15倍。一個判斷何時快速決策、何時慎重決策的框架。

8 分鐘閱讀