FormData.append()添加字段时值为空或被忽略的主因是value为null、undefined或空字符串；需检查值、规范类型转换、正确处理文件、区分append()与set()、谨慎拼接动态字段名，并确保前后端命名约定一致。
FormData.append() 添加字段时值为空或被忽略
常见现象是调用 formData.append('key', value) 后，后端收不到该字段。根本原因通常是 value 为 null、undefined 或空字符串，而 append() 不会报错，但浏览器实际不提交该条目。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 添加前显式检查值：
if (value != null && value !== '') formData.append('key', value) - 字符串值可统一用
String(value).trim()防止空格干扰 - 布尔值需手动转成字符串：
formData.append('active', active ? '1' : '0')，直接传true会被转成"true"，多数后端不认 - 日期建议用
toISOString()而非toString()，避免时区和格式歧义
动态添加文件字段（<input type="file">）的正确姿势
不能直接对 FileList 对象调用 append()，必须逐个取 File 实例。否则会静默失败或上传乱码。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 获取文件：用
input.files[0]或遍历input.files（注意不是input.value） - 添加单文件：
if (file) formData.append('avatar', file) - 添加多文件（同名字段）：
for (const file of input.files) formData.append('photos', file)，后端收到的是数组 - 若需带额外元数据（如描述），可额外 append 字符串字段：
formData.append('photo_desc', desc)
append() 和 set() 的关键区别与选型场景
append() 允许同名字段多次存在，set() 则覆盖前值。这直接影响后端接收逻辑——比如 PHP 的 $_FILES 只支持一次上传，但 $_POST 多值需用数组语法（name[]）。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 上传文件 + 表单字段混用时，统一用
append()，避免意外覆盖 - 明确只需要一个值的字段（如
user_id），可用set()防止重复添加 - 调试时用
console.log([...formData.entries()])查看实际键值对，确认是否重复或缺失 - 注意：
set()删除已有同名项再插入，append()是追加，两者不可混用同一字段而不清理
通过 JavaScript 动态生成字段名（如带索引、条件名）
常见需求：循环生成 item[0][name]、item[1][price] 这类嵌套字段名，但后端解析依赖命名规范，拼错就丢数据。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 字段名用模板字符串拼接，避免手写中括号错误：
formData.append(`items[${i}][name]`, name) - 嵌套层级深时，先构建对象再序列化（如用
qs.stringify()），但注意FormData原生不支持自动扁平化对象 - 若后端是 Laravel 或 Django，字段名含点号（
user.email）可能被截断，优先用下划线或中划线 - 动态字段名务必在前后端文档对齐，比如
status_2024和status_2025容易漏处理
console.log 确认键值。 
