formenctype 属性仅对 type="submit" 或 type="image" 的按钮生效，覆盖表单 enctype 设置，合法值为 application/x-www-form-urlencoded、multipart/form-data、text/plain（区分大小写），且 file input 必须配合 multipart/form-data 才能上传文件。

formenctype 属性只对 type="submit" 或 type="image" 的按钮生效

不是所有按钮都能触发 formenctype。只有显式声明为提交行为的控件才支持该属性——<button type="submit"></button>、<input type="submit"> 和 <input type="image">。如果写成 type="button" 或省略 type（此时默认是 button），点击后不会触发表单提交，formenctype 完全被忽略。

常见错误现象：给普通按钮加了 formenctype="multipart/form-data" 却发现请求仍是 application/x-www-form-urlencoded，根本原因就是没设 type="submit"。

• 务必检查按钮的 type 属性是否为 submit 或 image
• formenctype 是表单级覆盖，它会覆盖 <form enctype></form> 的全局设置
• 多个提交按钮可各自指定不同值，浏览器只按实际点击的那个生效

支持的值只有三个，且区分大小写

formenctype 只接受以下三个合法值（必须完全匹配，包括大小写和斜杠）：

• application/x-www-form-urlencoded（默认，不传文件时用）
• multipart/form-data（上传文件必需，注意 form-data 中间有短横线）
• text/plain（调试用，字段值不编码空格变 +，换行保留，但服务端很少处理）

写成 multipart/formdata、MULTIPART/FORM-DATA 或漏掉 text/plain 的引号，在 HTML 解析时不会报错，但浏览器会静默降级为默认编码，导致文件上传失败或字段乱码。

立即学习“前端免费学习笔记（深入）”；

Wechat Article Html

将 Markdown 文章转换为微信公众号兼容的纯 HTML 格式。当用户要求"转成微信格式"、"生成公众号文章 HTML"、"排版到微信草稿箱"、"微信粘贴格式"时触发。输出带内联样式的纯 HTML，微信编辑器可直接渲染，无需额外适配。支持标题、段落、列表、粗体、行内代码、表格、引用块、代码块、配图的完整转换。

下载

与

冲突时，以点击按钮的 formenctype 为准

表单本身有 enctype 属性，而某个提交按钮又有 formenctype，两者不一致时，浏览器以按钮上的值为最终提交编码。这个机制允许你在同一张表单里混用不同用途的提交方式。

例如：

<form action="/api" enctype="application/x-www-form-urlencoded">
  <input name="title">
  <button type="submit" formenctype="multipart/form-data">上传附件</button>
  <button type="submit">仅保存标题</button>
</form>

点第一个按钮，整个表单按 multipart/form-data 编码（含 title 字段）；点第二个按钮，则回退到表单级的 application/x-www-form-urlencoded。

• 注意：即使表单没设 enctype，也会默认使用 application/x-www-form-urlencoded，所以 formenctype 始终有参照基准
• 服务端框架（如 Express、Django）通常只监听一种编码类型解析 body，若按钮切换了编码却没对应处理逻辑，会导致解析失败或字段丢失

file input 必须配合 multipart/form-data，否则文件内容为空

这是最常踩的坑：<input type="file"> 控件的值永远不会出现在 application/x-www-form-urlencoded 编码的请求体中——浏览器直接跳过它。只有当编码是 multipart/form-data 时，文件二进制数据才会作为独立 part 发送。

如果你在表单里加了文件上传控件，又没确保至少一个提交按钮带 formenctype="multipart/form-data"，后端收到的永远是空文件。

• 不要依赖 JavaScript 拦截 submit 后手动改 enctype，DOM 修改不改变已生成的请求编码
• 也不要用 fetch + FormData 替代原生提交来“绕过”，这属于另一套机制，和 formenctype 无关
• Chrome DevTools 的 Network 面板里看请求头 Content-Type，确认是否含 boundary=，这是 multipart 的关键标识

实际项目里，最容易被忽略的是按钮 type 缺失和 formenctype 值拼写错误，这两个问题不会抛 JS 错误，但会让文件上传静默失败。