笔记
0工具
0此页用于记录用户反馈问题后的每一次改进
关于
“写笔记”支持四种格式——Word 文档、Excel 表格、Markdown、纯文本，起稿或二次编辑时都能随时切换，同一篇笔记想用哪种形态来记，都由你说了算。
md、txt、csv、json 这类纯文本则原样载入，不做多余加工。拿一张现成的表倒进来、改几笔、再导出去，等于白用一台免费的格式转换器。
要带走就在右上角点“下载”，可导出 PDF、Word、Markdown、Excel、TXT 等格式；列表卡片“⋯”菜单里，也有同样的下载入口。
在“工具”页点“＋ 上传工具”即可发布：填好名称与链接，再用 Markdown 把使用方法写清楚——能解决什么问题、怎么装、怎么用，比堆介绍实在。
要分发安装包就一并上传压缩包（ZIP、RAR、7Z、TAR.GZ，最大 35MB），别人在详情页一键下载；只放链接不带附件也可以。
工具按大家的收藏热度排序，好用的自然会被顶上来。发布后可在详情页或卡片菜单里编辑、下架。
写笔记时勾上“隐藏”，这篇就只存在于你自己的账号里：不进列表、不进搜索、不上首页精选，也不会出现在任何公开的页面，链接发给别人同样打不开。
适合放密码、草稿、日记这类只给自己看的内容；想公开，去“发布”打开它，把“隐藏”的勾去掉再保存，之后编辑会默认保持原状态，不会悄悄变回公开。
不想公开、只想临时给人看：点“分享”生成一条带密码和有效期的链接，到期自动失效，你也能随时撤销。
你的内容会同时保存在多个副本上，系统定期做备份与完整性校验，再配合异地容灾机制：就算某台机器出问题，数据也不会丢，可以长期放心存放；特别重要的资料，仍建议你另外再留一份备份。
全站跑在容器化、模块化的现代架构上，更新、部署、回滚都很快，扩展性和稳定性都按长期运营的标准来设计（Built for reliability, designed to scale）。
这个网站最早只是一个人的笔记仓库，后来慢慢长成现在的知识中枢。设计上很克制——没有广告、没有追踪、没有推荐算法，只是干干净净地存放一些东西；既然做好了，就公开出来，万一有人用得上呢。
不做大而全，不做平台梦，保持简单、保持克制、保持好奇。所有内容都由用户贡献、由用户维护：不会突然冒出付费墙，不会在角落塞广告位，也不会把你的数据卖给第三方。
产品会持续迭代，站内日志页记录着每一次改动，改了什么都有迹可循；想了解这个站是怎么一步步走到今天的，翻翻日志就能看到来龙去脉。
如果在这里看到涉嫌违规的内容，点对应卡片右侧的“举报”按钮就能提交，我们会尽快核实处理；也谢谢你花一点时间，一起把这里维护干净。
趋势
htmx 4.0 发布：从 XMLHttpRequest 到 fetch 的演进与属性继承的显式化
htmx 4.0 发布，核心变化是内部迁移到 fetch()、属性继承改为显式、事件命名标准化，并引入 morph swap 和
<hx-partial>标签。
引言
2026 年 8 月 28 日，htmx 团队正式发布了 4.0.0 版本。这是自 2.x 以来的一次重要更新，历时 8 个月开发，期间甚至附带了一个小游戏。对于大多数用户来说，htmx 4 在行为上与 2.x 几乎一致，但内部架构和若干关键机制发生了根本性变化。本文将从设计动机、主要变更、新特性、扩展生态和升级路径几个方面深入解读这次发布。
设计动机：从 XMLHttpRequest 到 fetch()
htmx 长期以来一直使用 XMLHttpRequest（XHR）作为底层 AJAX 实现，主要为了向后兼容。然而，XHR 的 API 设计老旧，对现代异步编程支持不佳，尤其在处理流式 HTML 时显得笨拙。
转折点出现在作者决定创建 fixi 时——一个基于 fetch() 的实验项目。在这个过程中，作者深入了解了 fetch() 和 JavaScript 异步编程。随后，Christian 联系作者，提出了关于流式 HTML 的一些想法，这促使作者考虑将 htmx 内部迁移到 fetch()。在获得 Michael 和 Alex 的支持后，团队启动了移植工作。
开发过程相对平顺。团队从 fixi 和 htmx 测试套件开始移植，逐步回顾 htmx 原有设计决策，使新实现越来越接近旧行为。最终，2.x 和 4.x 之间的行为差异被控制在较小范围，而每一项差异都经过了明确的设计取舍，目标是让基于 htmx 的应用能够成为“百年 Web 服务”。
值得注意的是，团队刻意没有将 4.0 标记为 NPM 的 latest，以避免强制升级依赖非版本化 CDN URL 的用户。2.x 将继续作为 latest，4.0 则作为 next 保留，直到 2027 年初。但官方网站已经切换到 4.0 版本。
三大主要变化
从用户视角看，htmx 4 与 htmx 2 几乎相同，但有三大关键变更：
1. 属性继承改为显式（最大的升级项）
在 htmx 2 中，许多属性默认继承给子元素。这个特性源自 intercooler.js 时代，灵感来自 CSS，但实际效果也如 CSS 一样：强大但难以理解。例如，在父元素上设置 hx-confirm，所有子元素都会受影响。
htmx 4 中，属性默认不再继承，除非显式在属性名后添加 :inherited 后缀。例如：
html
这将是升级过程中最大的工作量来源。为了减轻负担，团队提供了一个命令行工具，可以扫描代码并标出需要添加 :inherited 的位置。同时，hx-disinherit 等控制继承的属性已不再需要，应当移除。
2. 事件命名标准化
htmx 2 的事件名称是历史累积的结果，缺乏一致性，开发者难以判断何时触发哪个事件。htmx 4 统一采用 htmx:phase:action[:sub-action] 格式。例如：
| htmx 2 | htmx 4 |
|---|---|
htmx:beforeRequest |
htmx:before:request |
htmx:afterRequest |
htmx:after:request |
htmx:beforeSwap |
htmx:before:swap |
htmx:afterSwap |
htmx:after:swap |
htmx:configRequest |
htmx:config:request |
此外还有以下调整：
- 大多数错误事件合并为单一的
htmx:error。 - HTTP 错误响应触发
htmx:response:error。 - 移除
htmx:xhr:*系列事件（因为已改用 fetch()）。 - 移除
htmx:validation:*事件，改用浏览器原生表单验证。
完整的对照表见官方文档“What’s New in htmx 4”。升级检查工具也会在 hx-on 属性和 JavaScript 中标记旧事件名。
3. 历史支持不再默认使用 localStorage
htmx 一直内置历史支持，允许通过简单属性实现浏览器后退按钮感知。在 htmx 2 中，页面快照存储在 localStorage 中，用于恢复。但问题在于，快照可能包含第三方 JavaScript 库对 DOM 的修改；当页面从历史恢复时，这些 DOM 修改还在，但对应的 JS 逻辑已不存在，导致界面错乱。
htmx 4 不再使用 localStorage 缓存页面。后退导航时，htmx 会重新请求页面，并将内容交换到 <body> 或 [hx-history-elt] 指定的元素中。这样第三方库通常能“正常工作”，配合良好的请求缓存也非常快。
如果你确实需要本地缓存，团队提供了完整的 hx-history-cache 扩展，基于 sessionStorage 恢复历史，并设计为与 Alpine.js 等脚本方案良好集成。
新特性
htmx 4 带来两个令人兴奋的新特性：
1. Morph Swaps（形态交换）
htmx 4 原生支持 morph 交换。作者曾创建了 idiomorph 算法，原本计划在 2.x 中引入，但最终放弃。在 4.0 中，Michael 对算法进行了改进，并无缝集成到 htmx 中。Morph 交换允许更平滑地更新 DOM，只修改需要变化的部分，而不是整个替换目标元素，这能保留元素状态和动画，提升用户体验。
2. <hx-partial> 标签
这是另一个重要新特性。<hx-partial> 类似于 out-of-band swaps，但更清晰，尤其适合需要同时更新多个区域，而不仅仅是替换单个元素的场景。例如：
html
5
这样，一次响应可以更新多个目标区域，代码结构一目了然。
扩展生态
迁移到 fetch() 为扩展机制带来了新的可能性，催生了许多新扩展：
hx-preload：在鼠标悬停等时机预加载内容，加速请求。hx-download：基于 fetch 的原生文件下载。hx-alpine-compat：平滑 htmx 与 Alpine.js 之间的兼容性问题。hx-history-cache：在 sessionStorage 中缓存历史，并提供 Alpine.js 兼容。
此外，流式 HTML 扩展也得到更新：
hx-sse：通过text/event-stream流式传输。hx-ws：通过 WebSockets 流式传输和发送。hx-multipart：通过multipart/mixed流式传输。
团队还推出了自己的前端脚本方案 hx-live，灵感来自 Alpine.js、jQuery 和 hyperscript，与 htmx 紧密集成，支持所谓的“基于 DOM 的、HATEOAS 友好的响应式”。
为了方便使用，发行版中新增了 htmax.js 捆绑包，将 htmx 与最流行的扩展打包在一个文件中。
升级指南
完整的升级指南见“What’s New in htmx 4”。团队提供了命令行升级工具，可以自动标记需要 :inherited 的位置，并识别旧事件名。建议升级步骤：
- 运行升级工具扫描代码。
- 为需要继承的属性添加
:inherited后缀。 - 移除
hx-disinherit等旧属性。 - 更新事件监听器名称。
- 测试历史导航行为（若依赖 localStorage 快照，考虑使用
hx-history-cache扩展）。
总结
htmx 4.0 是一次稳健的架构升级，核心目标是现代化内部实现（fetch()）并简化长期积累的复杂性。对普通用户而言，升级负担主要集中在属性继承的显式化，但工具支持使得迁移相对平滑。新特性（morph swap、<hx-partial>）和扩展生态的丰富，为构建交互式 Web 界面提供了更强大的工具。
原文链接：https://four.htmx.org/announcements/2026-08-28-htmx-4.0.0-is-released