必须显式设置enctype="multipart/form-data"且method为post（或put等带body的方法），否则前端根本不会发送文件；默认application/x-www-form-urlencoded仅传空值或fakepath字符串，而multipart/form-data才能将文件切分为带Content-Disposition和真实Content-Type的二进制块。
必须显式设置 enctype="multipart/form-data" 且 method 为 post（或 put 等带请求体的方法），否则文件根本不会发出——不是后端收不到，是前端压根没传。
为什么 enctype 必须设为 multipart/form-data
浏览器默认用 application/x-www-form-urlencoded 编码表单，把所有字段转成 a=1&b=hello%20world 这类字符串。遇到 ，只传个空值或 C:\fakepath\abc.jpg 这种路径字符串，二进制内容直接丢弃。
只有 multipart/form-data 能让浏览器把文件切分成带 Content-Disposition 和真实 Content-Type 的二进制块（part），中间用随机 boundary 分隔。没它，HTTP 请求体里连 boundary= 都看不到。
- 漏写或拼错（如
mutlipart/form-data）→ 后端req.files或request.FILES为空 - 写在
上（如）→ 完全无效 - 用
GET提交 → 浏览器静默忽略enctype，文件字段被丢弃 -
enctype只作用于整个表单，不能继承、不能动态补加、不能靠 JS 提交时“事后弥补”
enctype 写错的典型表现和排查方式
常见错误包括：
-
❌ 大小写混乱（HTML虽不区分大小写，但易被误读为拼写错误；统一小写最稳妥） -
❌GET没有请求体，enctype被忽略 -
❌ 属性位置错 - 动态创建表单时：
const form = document.createElement('form'); form.enctype = 'multipart/form-data';，不设就还是默认编码
验证是否生效：打开浏览器 DevTools → Network → 点击上传请求 → 查看 Headers → 找 Content-Type 字段是否为 multipart/form-data; boundary=...。如果不是，说明 enctype 没生效。
把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件（幻灯片风格）。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本，并且希望生成演示用的 HTML 时触发。支持任意内容来源：iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区，并通过企微直接发送给用户。触发词示例：帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。
用 fetch + FormData 时 enctype 还管用吗
enctype 属性本身对 fetch 提交完全不生效——原生表单提交才看 ；用 JS 手动发请求时，起作用的是你构造的数据对象。
只要用了 new FormData(formElement) 或 FormData.append('file', input.files[0])，浏览器会自动设置 Content-Type: multipart/form-data; boundary=...。
- ✅ 正确：
fetch('/upload', { method: 'POST', body: new FormData(form) }) - ❌ 错误：
fetch('/upload', { headers: { 'Content-Type': 'application/x-www-form-urlencoded' } })—— 手动覆盖会导致文件无法解析 - ⚠️ 注意：
FormData构造时若传入的form元素没设enctype，不影响 JS 行为，但可能误导维护者
后端解析失败，前端 enctype 设置对了也不行？
即使前端 enctype 正确，后端仍收不到文件，大概率是解析中间件没配或配错：
- Express + multer：必须挂载
multer({ dest: 'uploads/' })中间件，且路由 handler 要在它之后 - Django：确保视图函数里用的是
request.FILES而非request.POST，且表单name与后端取值 key 一致 - PHP：
$_FILES数组依赖enctype和method="POST"，缺一不可
最容易被忽略的一点：后端框架往往要求 multipart/form-data 请求的 boundary 长度和格式合法，而某些代理（如 Nginx 默认配置）会截断超长 header 或重写 Content-Type，导致解析失败——这时要检查代理层日志，而非只盯着前端代码。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
