HTMX 并非真正“无 JavaScript”，而是将交互逻辑从手写 JS 转为 HTML 属性声明；它依赖 htmx.js 运行，hx-get 等属性由该脚本解析执行，后端须返回 HTML 片段而非 JSON。
HTMX 的 hx-get 本身不依赖“无 JavaScript”——它必须有 JavaScript 才能运行。 这是个常见误解。HTMX 是一个 JavaScript 库，hx-get 是它提供的声明式属性，浏览器原生 HTML 完全忽略它。所谓“无 JavaScript”的说法，其实是对比传统手写 fetch() 或 jQuery AJAX 而言：你不用自己写 JS 逻辑，但 HTMX 的 JS 脚本必须加载并执行。
为什么 hx-get 看起来像“无 JS”？
因为行为完全由 HTML 属性驱动，开发者不写一行事件监听或请求逻辑：
-
hx-get告诉 HTMX：“点这个元素时，发 GET 请求” -
hx-target指定把响应内容插入哪个元素（如hx-target="#list"） -
hx-swap控制如何替换（如hx-swap="innerHTML"或hx-swap="afterend"） - HTMX 自动绑定 click、submit 等事件，并接管请求生命周期
最简可用的 hx-get 示例
确保已引入 HTMX（CDN 最快）：
<script src="https://unpkg.com/htmx.org@2.0.0"></script>
然后写纯 HTML（无需额外 JS）：
立即学习“Java免费学习笔记（深入）”；
<div id="result">初始内容</div> <button hx-get="/api/time" hx-target="#result" hx-swap="innerHTML">获取当前时间</button>
点击按钮后，HTMX 会：
- 向
/api/time发 GET 请求 - 把响应的 HTML 片段（不是 JSON！）直接写入
#result元素内部 - 整个过程无页面刷新、无手动 JS 编写
⚠️ 注意：后端返回必须是 HTML 片段（如 <time>14:22:05</time>），不是 {"time": "14:22:05"} ——否则会原样显示 JSON 字符串。
容易踩的坑：404、CORS、响应格式、事件绑定时机
常见失败现象和对应检查点：
-
点击没反应：检查浏览器控制台是否有
htmx:configError或Failed to load resource；确认<script>标签在 DOM 渲染前已加载（放在</body>前最稳） - 请求 404 或 500：HTMX 不拦截错误响应，它会照常尝试插入内容；用浏览器 DevTools 的 Network 面板看请求 URL 和状态码
-
跨域失败（CORS）：HTMX 的请求受同源策略限制，和
fetch()一样；后端需设置Access-Control-Allow-Origin，不能靠 HTMX 规避 -
插入空白或乱码：90% 是后端返回了非 HTML 内容（如 JSON、空响应、带重定向的 302）；用 curl 测试：
curl -i http://localhost:8000/api/time，确认响应头含Content-Type: text/html且响应体是有效 HTML
真正“无 JavaScript”的替代方案只有原生 <form method="get"> + 页面跳转，或者 Web Components 自定义元素（仍需 JS）。HTMX 的价值在于用最小 HTML 声明换取丰富交互，但它绝不是零 JS 方案——别在生产环境里漏掉 <script> 标签，也别指望禁用 JS 后它还能工作。
