Netlify表单处理功能需在form标签中添加netlify或data-netlify="true"属性才能被构建时识别，否则数据将被静默丢弃；所有表单字段必须有name属性，且不支持文件上传。
Netlify 表单处理功能在静态站点中能直接收数据，但必须满足一个硬性前提：form 标签得带 netlify 或 data-netlify="true" 属性，否则 Netlify 构建时根本不会识别它——不是“不工作”，而是压根没被扫描进处理队列。
表单 HTML 必须带 netlify 属性才能被识别
Netlify 不是监听 submit 事件的 JS 库，而是在构建阶段静态解析 HTML 文件。它只认两个标识：
-
<form netlify>（最简写法，推荐） -
<form data-netlify="true">（语义更明确）
漏掉这个属性，哪怕后端逻辑再完善、邮件通知配置得再细，提交的数据也会 404 或静默丢弃。常见错误现象是：页面显示“提交成功”，但 Netlify 后台表单列表里空空如也。
注意：action 和 method 属性可以省略——Netlify 会自动覆盖为 POST 并指向自己的接收端点；但 name 属性不能少，每个 input、textarea、select 都得有 name，否则字段值不会被收录。
立即学习“前端免费学习笔记（深入）”；
提交后跳转与用户体验控制
默认提交后页面会刷新并停留在当前页，用户看不到反馈。你需要显式指定成功行为：
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
- 加
data-netlify-honeypot="bot-field"到form上，并配一个隐藏的<input name="bot-field" style="display:none">，这是启用 Akismet 垃圾过滤的必要条件 - 用
data-netlify-recaptcha="true"开启 reCAPTCHA（需先在 Netlify 后台启用） - 设置
data-success="/thank-you.html"实现提交后跳转——这个路径必须是静态文件，且部署后真实存在
如果跳转失败（比如路径 404），Netlify 会 fallback 显示默认成功提示，但样式简陋，容易让用户困惑。
后台查看与导出数据的限制
Netlify 后台的表单管理界面（/site/{site-id}/forms）能看最近 100 条提交，这是免费计划的硬上限。超过后旧记录会被自动归档，无法在 UI 中翻页查看。
导出数据只有 CSV 一种格式，不支持 JSON 或 Excel；字段顺序严格按 HTML 中 input 出现的顺序排列，不能重排或筛选。如果你依赖某字段做自动化处理，务必确认它的 name 拼写和大小写完全一致——Netlify 不做字段名标准化。
Webhook 转发要注意请求体结构
配置外出 Webhook（比如推到 Slack 或自建 API）时，Netlify 发送的是标准 application/x-www-form-urlencoded 请求体，不是 JSON。你收到的原始数据类似：
name=张三&email=zhang%40example.com&message=hello
如果你的接收端期望 JSON，就得自己解析并转换。另外，Webhook 默认无重试机制，网络超时或 5xx 响应会导致该次提交丢失——生产环境建议加一层消息队列或至少记录失败日志。
真正容易被忽略的是：Netlify 表单不支持文件上传。任何 <input type="file"> 字段都会被跳过，且不报错。需要传文件？只能换用 Serverless Function 自行实现接收逻辑。
