formenctype仅在method="post"的表单中，对type="submit"或type="image"的<input>生效；若未设method="post"、使用<button>或JS调用submit()，该属性均被忽略。
formenctype 必须配合 method="post" 才生效
不写 method="post"，formenctype 就是摆设——浏览器直接忽略它，哪怕你写了 formenctype="multipart/form-data"，提交时仍走默认的 application/x-www-form-urlencoded 编码。这不是 bug，是规范强制要求：formenctype 只对 type="submit" 或 type="image" 的 <input> 生效，且仅在 method="post" 表单中起作用。
常见错误现象：
- 点了「上传文件」按钮，后端
req.files为空，但req.body有文本字段 → 很可能表单用了method="get"或没写method - 写了
formenctype却没效果 → 先检查<form>标签是否漏了method="post"
只能用在 <input type="submit"> 上，不能用在 <button> 或 <a>
formenctype 是 <input> 的专属属性，不是通用 HTML 属性。把它写在 <button type="submit"> 或链接上，浏览器完全无视，连 warning 都不会抛。
使用场景很具体：一个表单里有两个提交按钮，一个存草稿（纯文本），一个正式提交（带文件）。这时你得这样写：
<form action="/api/save" method="post"> <input name="title" value="test"> <input type="file" name="cover"> <input type="submit" value="存草稿" formenctype="application/x-www-form-urlencoded"> <input type="submit" value="发布" formenctype="multipart/form-data"> </form>
注意：
-
<button type="submit">无法携带formenctype，必须换成<input type="submit"> - 如果用 JS 绑定 click 并调用
form.submit()，formenctype不会生效 —— 它只响应原生点击触发的提交 -
formenctype不继承，也不受 JS 动态设置影响（比如input.formenctype = '...'在提交瞬间才读取）
三个值的实际行为差异远超文档描述
application/x-www-form-urlencoded、multipart/form-data、text/plain 看似只是编码不同，但实际影响的是整个请求体结构和后端能否拿到数据。
关键区别：
-
application/x-www-form-urlencoded：所有字段 URL 编码，<input type="file">的值变成空字符串或C:\fakepath\xxx.jpg（仅路径名，无二进制） -
multipart/form-data：每个字段独立成 part，文件字段带Content-Disposition: form-data; name="xxx"; filename="a.png"和原始字节流 —— 后端必须用 multipart 解析器（如 multer、request.files）才能提取 -
text/plain：空格变+，其余字符不编码（中文直接发乱码），且<input type="file">同样被丢弃 —— 仅适合调试表单字段名是否拼对，别用于生产
设错值的后果很直接：比如给文件按钮配 formenctype="text/plain"，后端收到的请求头仍是 Content-Type: text/plain，但文件内容根本不在请求体里，req.files 一定为空。
后端收不到文件？先看请求头和请求体结构
前端写了 formenctype，后端却拿不到文件，大概率不是代码问题，而是请求压根没按 multipart 格式发出。抓包看两点：
- 请求头
Content-Type是否为multipart/form-data; boundary=----WebKitFormBoundaryxxx - 请求体是否包含多个以
--boundary分隔的 part，且文件 part 有filename=和二进制块
如果看到的是 Content-Type: application/x-www-form-urlencoded，说明 formenctype 没生效 —— 常见原因包括：<form> 没写 method="post"、用了 <button> 而非 <input type="submit">、JS 阻止了默认提交但没手动构造 FormData。
容易被忽略的一点：formenctype 是静态属性，它不随 JS 修改表单状态而变化。哪怕你动态插入了 <input type="file">，也得确保对应提交按钮的 formenctype 值正确，且表单本身已声明 method="post"。
