Flatpickr 不能替代 input[type="date"] 的语义与无障碍能力，仅覆盖交互体验；需显式导入中文语言包、正确配置 dateFormat/altFormat、locale.firstDayOfWeek、disable 函数，并在 Vue 中透传 allowInput 和 time_24hr 才能完整支持中文、星期起始、禁用日期及键盘输入。
Flatpickr 不能直接“替代” <input type="date"> 的语义和无障碍能力，但能覆盖其交互体验——关键在于不改 DOM 结构、只接管行为，同时补全原生缺失的配置项（如中文、起始星期、秒级精度等）。
必须引入中文语言包才能显示中文界面
只设 locale: "zh" 不生效，flatpickr/dist/l10n/zh.js 必须显式 import，且要在 flatpickr 主库之后加载：
- CDN 方式需按顺序引入：
<script src="https://cdn.jsdelivr.net/npm/flatpickr"></script>→<script src="https://cdn.jsdelivr.net/npm/flatpickr/dist/l10n/zh.js"></script> - ESM 或 Vue 项目中，import 顺序不能颠倒：
import flatpickr from "flatpickr"必须在import "flatpickr/dist/l10n/zh.js"之前 - 未正确加载时，控制台不会报错，但月份/星期仍为英文，
firstDayOfWeek也不起作用
dateFormat 和 altFormat 配合才能兼顾显示与提交格式
用户看到的格式（输入框里）和你实际拿到的值（fp.selectedDates[0] 或 fp.formatDate()）可以不同。常见错误是只配 dateFormat，导致后端收到 “2026年6月17日” 这类字符串而无法解析：
-
dateFormat: "Y-m-d H:i:S"：决定最终提交给后端的格式（ISO 兼容） -
altFormat: "F j, Y"+altInput: true：仅用于显示，不影响值；适合展示“六月 17, 2026”这类友好格式 - 若不需要替代显示，
altInput可省略，但dateFormat必须明确，否则默认是"Y-m-d"，不包含时间
起始星期和禁用日期必须通过 locale 或 disable 函数控制
原生 <input type="date"> 固定以星期日为第一天，Flatpickr 则靠 locale.firstDayOfWeek 调整——注意这不是全局设置，必须写在实例配置里：
立即学习“前端免费学习笔记（深入）”；
-
locale: { firstDayOfWeek: 1 }表示周一为第一天（中国、德国等常用） -
disable支持数组或函数，禁用周末写法：disable: [date => date.getDay() === 0 || date.getDay() === 6] - 不要混用
minDate和disable做同一件事：前者限制范围，后者屏蔽具体日期；两者叠加时，disable优先级更高
Vue 项目中别漏掉 allowInput 和 time_24hr 组合
在 Vue 场景下，用户常需要键盘直接输入日期时间（尤其后台表单），此时 allowInput: true 是刚需，但它和 time_24hr 强相关：
-
allowInput: true开启手动输入，但若没设time_24hr: true，输入 “14:30” 会被自动转成 “2:30 PM”，再提交就乱了 - 要支持秒级输入，除了
enableSeconds: true，还得在dateFormat中加s，例如"Y-m-d H:i:s" - Vue 封装组件（如
vue-flatpickr-component）会代理部分配置，但allowInput和time_24hr仍需透传，不能只靠父组件 props 默认值
真正容易被忽略的是：Flatpickr 初始化后，DOM 上的 input 元素类型仍是 text，它不触发原生 input[type="date"] 的校验逻辑（比如 required 提示、移动端日期键盘）。如果项目依赖这些特性，得额外监听 change 或用 onClose 手动校验值合法性。
