enctype="multipart/form-data" 必须写在标签上且method="post"，否则文件无法上传；后端需匹配解析中间件并确保name属性与接收字段名一致。
enctype="multipart/form-data" 必须写在 <form></form> 上，不是 <input>
很多人把 enctype 加到 <input type="file"> 标签里，或者只在 JS 里动态改 input 的属性——这完全无效。浏览器只认 <form enctype="..."></form> 这个顶层声明。
常见错误现象：req.files 为空、$_FILES 是空数组、request.files.get("avatar") 返回 None，但 req.body 或 $_POST 能取到文本字段。
-
<form></form>没写enctype→ 默认用application/x-www-form-urlencoded，文件变成字符串[object File]或空名 -
<form enctype="text/plain"></form>→ 后端根本没法结构化解析，name=value关系丢失 - JS 动态改
form.enctype = "multipart/form-data"但没重置submit事件绑定 → 表单仍按旧编码提交
含文件上传时，method="post" 不能省略
GET 方法根本不支持 enctype="multipart/form-data" —— 浏览器会静默忽略它，降级成 GET /path?name=xxx，文件字段只剩文件名，二进制内容彻底丢弃。
使用场景判断很直接：只要表单里有 <input type="file">，就必须同时满足两个条件：method="post" + enctype="multipart/form-data"。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
-
method不写默认是GET，不是POST；HTML 规范明确写了这点 -
enctype在GET下无效，浏览器不会报错，但请求体为空，后端收不到任何文件数据 - 即使你用
fetch提交FormData，也必须配method: "POST"，否则服务端路由匹配失败（比如 Express 的app.post()不触发）
重置 enctype 后，后端解析中间件必须匹配
前端设了 enctype="multipart/form-data"，只是让浏览器打包出带 boundary 的请求体；后端若没对应解析器，照样拿不到文件——不是 404，而是 req.file 或 $_FILES["avatar"] 为 null 或空。
典型不匹配现象：表单提交成功（HTTP 200），但日志显示 req.files === {} 或 $_FILES["avatar"]["error"] === 4（即 UPLOAD_ERR_NO_FILE）。
- Express + Multer：必须显式调用
upload.single("avatar")或upload.array("photos", 5)，不能只app.use(multer()) - Flask：要用
request.files.get("avatar")，不是request.form.get("avatar")；且需确认environ["CONTENT_TYPE"]确实以multipart/form-data开头 - PHP：
$_FILES数组存在但error字段非0，大概率是post_max_size或upload_max_filesize超限，不是enctype问题
绝对路径 action + 正确 name 才能让后端收到字段
enctype 设对了，不代表后端能拿到数据。两个硬性依赖：一是 action 必须指向真实存在的 POST 接口（且协议/域名/路径全对），二是每个 <input> 必须有 name 属性，且和后端读取的键名完全一致（大小写敏感）。
容易被忽略的坑：name="userAvatar" 前端写了驼峰，后端却用 req.body.useravatar 或 $_POST["useravatar"] 去取——永远为空。
-
action="api/upload"→ 实际发到当前页路径下，如/admin/api/upload，不是根路径 -
action="/api/upload"→ 正确，从域名根开始，部署迁移也不怕 -
<input type="file" name="avatar">→ 后端必须按"avatar"这个字符串去取，不能写成"file"或"image" - 多个同名
file输入（带multiple）→ 后端收到的是数组，不是单个对象；Flask 用request.files.getlist("photos")，Express + Multer 用upload.array("photos")
Content-Type 头是不是 multipart/form-data; boundary=----WebKitFormBoundary...，再确认请求体里有没有分块结构（搜 ----boundary）、有没有 filename="xxx.jpg"。这两点都满足，问题一定出在后端解析或字段名匹配上。前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
