Vuetify 2026 年 7 月更新解读：Vuetify 3 进入 LTS、Vuetify0 1.0 稳定发布与 v4.1 补丁线

Vuetify 2026 年 7 月更新解读Vuetify 3 进入 LTS、Vuetify0 1.0 稳定发布与 v4.1 补丁线【免费下载链接】vuetify Vue Component Framework项目地址: https://gitcode.com/gh_mirrors/vu/vuetify本篇文章完整解读 Vuetify 官方《July 2026 Update》月度更新原文位于 packages/docs/src/pages/en/blog/july-2026-update.md覆盖当月两项里程碑Vuetify 3.13.0 作为 v3 线最后一个 minor 版本发布并进入长期支持LTS以及Vuetify0 1.0 正式稳定。同时梳理 v4.1 补丁线的每周节奏、Shadow DOM 与 defaults 继承等关键修复、Vuetify CLI 新命令与 pkg-diff 工具上线。读完你可以掌握当前 Vuetify 各版本线的支持状态、v3 → v4 的迁移时间窗口以及 v3.13.0 新增特性的源码级细节与升级判断依据。月度总览一个数据驱动的七月2026 年 7 月统计区间为 7 月 1 日至 31 日America/Chicago 时区按提交日期与合并日期计的产出可以用一张表概括指标数量总提交数Commits386合并 PR 数264活跃仓库数11Vuetify 框架发布9v4.1.3 → v4.1.7v3.12.9 → v3.13.0组件转正Promoted0framework· 13Vuetify0 稳定组件脊柱Vuetify0 发布11 个 tag含v1.0.0原文档特别说明统计时master、dev、v3-stable分支之间的 cherry-pick 与 back-port 只计数一次不会因跨分支而重复计入。两个里程碑定义了这一个月v3.13.0 是 Vuetify 3 能获得的最后一个 minor 版本此后 v3 线只接收关键 bug 修复与安全补丁为期十二个月Vuetify0 1.0 首次为框架的逻辑层提供了 semver 锁定的 API 表面这正是 theme、locale、date 三项迁移所等待的落点。从工作量的分布看当月 264 个合并 PR 中有 214 个落在vuetifyjs/0仓库——团队在发布前将精力集中在加固既有 API 表面而非新增功能。框架侧相对安静34 个合并 PR没有 labs 组件转正没有新组件但在 v4 与 v3 两条线上一共发布了 9 个版本此外 v0 上的可访问性accessibility专项占据了剩余工作量的较大份额。Releases九次框架发布7 月两条版本线共发布九次。v4 线保持每周补丁节奏v4.1.37 月 2 日v4.1.47 月 7 日v4.1.57 月 13 日v4.1.67 月 23 日v4.1.77 月 30 日v3 线先发布三个补丁版本v3.12.9、v3.12.10、v3.12.11随后在 7 月 27 日发布v3.13.0。所有版本的详细记录可查阅仓库中的 getting-started/release-notes.md。Key ImprovementsVuetify 3.13—— 最后一个 v3 minorv3 线自此进入 LTS持续至 2027 年 7 月 27 日。VSelect / VAutocomplete / VCombobox—— 新增多选multi-selection事件外加一系列焦点与原生表单提交修复PR #23038、#23022、#23029。VSkeletonLoader—— 新增typesprop、chip-group类型并重新引入table-cell类型PR #23037。VBtnGroup—— 新增与独立按钮对齐的sizepropcommiteada595。Shadow DOM—— 在开放的 shadow root 内修正键盘导航与焦点解析PR #23024、#23027。Defaults—— 嵌套的根级 defaults 在 teleport 重置后得以保留父级配置不再泄漏进 menu 与 dialog 内容PR #23015、#23016。Vuetify 3 进入 LTSVuetify 3 于 2022 年 11 月 1 日首次发布。近四年、十三个 minor 版本之后v3.13.0 是它的收官之作。自 2026 年 7 月 27 日起v3 线进入长期支持状态只接收关键 bug 修复与安全补丁别无其他直到2027 年 7 月 27 日。两个需要特别注意的数字变化LTS 窗口从 18 个月缩短为 12 个月。旧政策为退出的 major 提供 18 个月支持现调整为 12 个月。官方已同步更新了 long-term-support.md 与 why-vuetify.md发布周期说明请在制定迁移计划时按新数字核算。仓库中的 LTS 支持矩阵见 packages/docs/src/pages/en/introduction/long-term-support.md当前记录为Vuetify 4.x 处于 Active 状态2026 年 2 月 23 日首发Vuetify 3.x 处于 Maintained 状态2022 年 11 月 1 日首发2026 年 7 月 27 日进入 LTS2027 年 7 月 27 日结束Vuetify 2.7 与 1.5 均已归档。v3.13.0 不只是最后一个 minor它同样携带新功能。7 月的四项新特性全部只在这个版本发布——在 v4 线上同样的提交位于dev分支排队进入 9 月的 v4.2.0。这些特性与 5 月 back-port 回来的可访问性工作一同到达VSelect / VAutocomplete / VCombobox—— 多选新事件PR #23038。VDataTable—— 社区贡献的mobile.header插槽PR #21429可排序列的aria-sort以及选择控件上的aria-label。VSkeletonLoader——typesprop、chip-group、table-cell。VBtnGroup——sizeprop。v3 文档继续停留在 v3.vuetifyjs.com同时官方文档站清理了过时的跨版本内容commite3fb29d。如果你仍在使用 v3建议从 upgrade-guide.md 开始规划迁移——文档明确提醒你有一年的时间。Vuetify0 1.0Vuetify0v0于 7 月 22 日发布 1.0。包名现在是纯粹的vuetify/v0——不再需要beta、rc或任何 dist-tag。作为对照完整的 1.0 公告位于 packages/docs/src/pages/en/blog/announcing-vuetify0-v1.md其中明确 v0 是一个headless meta-framework面向 Vue 3 的逻辑层只提供状态、可访问性与行为不渲染任何样式1.0 意味着契约被锁定19 个 composables、17 个 utilities、13 个组件在 1.x 全系享有无破坏性变更保证且该冻结由 CI 机制强制执行——任何改动公共表面的 PR 都会让仓库检查失败。7 月是如何走到 1.0 的月初以 RC 开局。v1.0.0-rc.6于 7 月 2 日发布同期有10 个 composables 从 preview 转正为 stablecreateModel、createSelection、createSingle、createStep、createGroup、createNested、createRegistry、useTheme、useStorage、useBreakpointsPR #470。随后又发布三个 RC。7 月 20 日1.0 组件脊柱一次性转正——13 个组件Atom、AspectRatio、Theme、Group、Selection、Single、Step、Tabs、Toggle、Collapsible、Checkbox、Radio、SwitchPR #655稳定组件数量从 0 直接到 13。两天后v1.0.0 正式发布。7 月没有新增任何 composable 或组件。API 自 6 月 beta 起就已冻结整个月都在硬化既有能力——可访问性、性能与正确性。紧随其后还有两个补丁v1.0.17 月 24 日与v1.0.27 月 29 日。可访问性v0 引入了基于axe-core的扫描现已覆盖每一个组件PR #736。此前的修复包括Avatar、Scrim、Popover、Tooltip、Select、Toggle—— 恢复丢失的 alt 文本补齐缺失的 ARIA 接线PR #618。Switch、Form、Slider—— 修正 mixed 状态、原生校验与分组控件的 ARIA 状态PR #619。Carousel—— 键盘聚焦时自动播放暂停满足 WCAG 2.2.2PR #625。Snackbar—— 新增urgentprop将 live region 切换为rolealertPR #624。Breadcrumbs—— 折叠项计数与展开器上的aria-expandedPR #634。Button、Toggle、Pagination—— 非原生as元素上的 Enter/Space 激活PR #645。Treeview—— 激活项上的aria-currentPR #626Splitter—— 本地化的手柄标签PR #627。性能createRegistry位于 v0 大部分组件之下因此获得了最多关注响应式keys/values/entries在版本信号version signal之后被 memo 化PR #540仅字段的 upsert 跳过版本通知PR #542热路径去掉了indexOf与一次values()拷贝PR #531。createDataGrid在没有手动排序生效时跳过排序时的行重排PR #555。此外createGroup、createSingle、createStep建立了基线基准测试以便将来发现回归PR #604关键导出有包体积门禁PR #605并新增了 SSR hydration 冒烟测试框架PR #607。正确性如果你当时在跑 RC以下四个修复值得关注useResizeObserver此前静默忽略 border-box 测量PR #725。isArray与isObject现在能正确针对 element types、tuples 与readonly收窄类型PR #745、#746。useStack的单例在 SSR 请求间泄漏PR #569。一次安全评审产出了针对原型污染prototype pollution与 CSS 注入的守卫扫描PR #489。同时落地两项结构性变更vuetify/paper退出发布路径PR #671并移出面向消费者的文档PR #672发布流水线现在阻止 prerelease 抢占latestdist-tagPR #665并让发布具备幂等性PR #696——两者都是今年早些时候 tagging 问题的后续。Framework Updates7 月框架侧没有 labs 组件转正也没有新组件——上一次转正是 5 月的七个。团队把精力集中在正确性上三大焦点Shadow DOM、defaults 继承与select 家族。New Features四项新特性都在 7 月 27 日落地且全部随 v3.13.0 发布而非 v4 线。在 v4 线上相同提交合入dev随 v4.2.0 到达VSelect / VAutocomplete / VCombobox—— 多选新事件PR #23038。VSkeletonLoader——typesprop重新引入table-cellPR #23037另有chip-group类型commit06cbc10。VBtnGroup—— 与独立按钮对齐的sizepropcommit9b46baa。以仓库源码佐证这两项特性VSkeletonLoader 的实现位于 packages/vuetify/src/components/VSkeletonLoader/VSkeletonLoader.tsx。其中rootTypes常量定义了全部内置骨架类型——例如chip-group: chip8、table-cell: text——而types: Object as PropTypeRecordstring, string正是新增的typesprop它允许用户传入自定义类型映射与rootTypes合并后驱动递归的genStructure骨骼生成逻辑。typeprop 默认值为ossein且支持字符串或数组。VBtnGroup 的实现位于 packages/vuetify/src/components/VBtnGroup/VBtnGroup.tsxmakeSizeProps({ size: undefined })展开后provideDefaults会把size透传给内部的VBtn并通过v-btn-group--has-size: props.size ! null的 class 在横向布局下自动把按钮高度调整为auto从而实现与独立按钮一致的尺寸表现。Bug FixesShadow DOM。挂载在开放 shadow root 内的组件此前把焦点解析到错误的 root导致列表中的键盘导航失效、对话框中的焦点被抢占。三个修复封堵了这一问题PR #23024、#23027、commit8908e7e。Defaults。两处泄漏父组件配置泄漏进 teleported 的 menu 与 dialog 内容PR #23016嵌套的根级 defaults 被 teleport 重置丢弃PR #23015。任一处都会导致组件在隔离环境中样式正确、在实际位置中样式错误。select 家族。焦点行为、原生表单提交与列表可靠性都得到了修复。这些大多是长期存在的报告而非 v4.1 的回归。下表完整收录原文档列出的当月修复v4.2.0 行表示已合入dev、截至 7 月底尚未在 v4 线发布组件修复内容版本PR / commitlocale正确将 Kurdish locale 解析为 RTLv4.1.34782312VBtnRTL locale 下不应用 letter-spacingv4.2.03956c08VOtpInputRTL 模式下正确移动焦点v4.1.3f0145aaVSelect/VAutocomplete/VCombobox尊重no-auto-scrollv4.1.3adb2597VDataTable对 align 为start的列应用text-alignv4.1.302f5f81VDateInputblur 时不再填充 rangev4.1.4b7569ferounded将2xl、3xl等翻译为对应 classv4.1.30ea03f4VDateInput从 date adapter locale 派生显示格式v4.1.3PR #22976themeprovideTheme的 current 应使用computedThemesv4.1.4PR #22987VMenu修正嵌套菜单的关闭级联v4.1.45902e09VMenu内容尺寸变化时修正 click-outside 检测v4.1.4007f546VNumberInput接受非 ASCII 负号v4.1.46063d7aVNumberInputprecision为 null 时保留全部小数v4.1.487b0e57date修正StringDateAdapter的 localev4.1.483ed8d4VOverlay非激活 overlay 跳过 click-outside DOM 扫描v4.1.574e297fVTreeview更多 aria 属性与正确的键盘导航v4.2.0PR #22903VDataTable移动视图下隐藏空表头单元格v4.1.5a759055VCalendar自定义 intervals 时阻止跨天小时v4.1.54e36892VSwitch在 Sass 中解析 inset thumb 缩放比例v4.1.586fcfaatypes在产出的声明文件中保留RouteLocationRawv4.1.5d4d7b4bVMaskInput在选区上粘贴时保留值v4.1.5PR #23003VImg处理被 Nuxt 页面过渡延迟的 image refv4.1.60f72bafVList开放 Shadow DOM 内的键盘导航v4.1.6PR #23024VDialog/VFieldShadow DOM 中正确的焦点解析v4.1.6PR #23027VDialog将自动聚焦推迟到内部字段可聚焦时v4.1.68908e7eVSelect仅当用键盘打开时才聚焦第一项v4.1.64bb9151VSelect首次点击外部即释放焦点v4.1.6ff966d2defaultsteleport 重置后保留嵌套根级 defaultsv4.1.6PR #23015VDataTableVirtual修复展开行导致的滚动抖动v4.1.6PR #23014VVirtualScroll底部追加时裁剪前导项v4.1.61ac7cb7VVirtualScroll在updateOffsets之后调用calculateVisibleItemsv4.1.6PR #22938VOverlay正确处理 target 赋值的transitionpropv4.1.6PR #22190defaults避免父级配置泄漏进 menu 与 dialog 内容v4.2.0PR #23016VStepperWindow/VTouch仅在 touch 处理器非空时移除v4.1.7PR #23030VStepperVerticalItem移除 step 内容上多余的 error 颜色v4.1.7fce4eaav-touch响应绑定值的变化v4.2.0937a471v-tooltip正确处理true与undefinedv4.2.0cef88bfVAutocomplete/VCombobox为 prepend icon 与 avatar 驼峰化 item propsv4.1.78a20623elevationhover-elevation不应要求elevationv4.1.7378f593VProgressLinear/VIconBtn避免 Vite v8 丢弃 transition timingv4.1.7f23af8aVTextField与 counter 共存时尊重hide-detailsautov4.1.7PR #22620另有一项修复在 7 月 31 日落地但月内尚未发布VNumberInput在解析前剥离分组分隔符commit94e94a9。In Developmentv4.2.0 里程碑定在9 月 1 日承接错过 v4.1 的特性工作。队列与 6 月相比基本未变如今有了明确日期VSlider—— 对齐 MD3 的pill变体PR #22699。VMaskInput—— 多重与动态 mask 解析PR #22501。VTimePicker—— 键盘控制PR #22604。VBtn / VIconBtn—— 对齐 MD3 的尺寸、间距与焦点PR #21831。VDatePicker—— 周选择PR #20867。VField——borderpropPR #19819。7 月新开、截至月底仍未关闭的还有select 家族的持久菜单PR #23008以及 VAutocomplete 与 VCombobox 的close-on-input-clickpropPR #23023。Tooling UpdatesVuetify CLICLI 在 7 月发布四个版本并新增一条命令。vuetify release-notesPR #23可以直接在终端打印 Vuetify 或 Vuetify0 的发布说明npx vuetify release-notes # 最新的 Vuetify 发布 npx vuetify release-notes v0 # 最新的 Vuetify0 发布 npx vuetify release-notes --version v4.1.7该命令直接读取 GitHub Releases API——无新增依赖——并同时链接到文档的 release-notes 页面与 GitHub release。它随v1.2.0-beta.3发布并于 7 月 15 日在v1.2.0转正。vuetify analyze获得一项正确性修复PR #26此前小写create*工厂如createSelection、createRegistry被归类为 utilities 而非 composables——因为内置 import map 缺少composables键约三十个核心 v0 composables 被错误标记。Nuxt 模板现设置prefixComposables以避免上游引入的命名冲突issue #25将项目转换为 JavaScript 时的 feature 应用也已修复PR #19。版本线v1.2.0-beta.27 月 1 日· v1.2.0-beta.37 月 15 日·v1.2.07 月 15 日· v1.2.17 月 22 日。pkg-diffpkg-diff 是 6 月安全工作中诞生的浏览器内 NPM 包差异对比工具7 月正式上线。当月全部十五个提交都投入到它Coolify 部署、无障碍主题、按 dist-tag 分组的版本下拉框、avprevURL 参数以及一个 CLI——agent 无需浏览器即可对比两个包版本。配套的 Vuetify CLIrelease-notes输出链接于 7 月 25 日合并晚于 v1.2.1因此截至月底尚未随版本发布。Vuetify MCPMCP server 于 7 月 22 日发布v0.8.0将其已发布的 composable 与组件清单与 v0 1.0 重新同步PR #26、#27。如果用它做 v0 查询建议升级——0.8.0 之前的任何版本都早于 1.0 的 API 表面。Nuxt ModuleNuxt module 于 7 月 20 日达到v1.0.0-rc.3新增composables 的选择性导入与前缀化——当 Vuetify 的 composable 名称与项目自身的 auto-imports 冲突时尤其有用。rc.2 于本月早些时候发布。Backend Fixes不面向用户但值得记录。所有非正常路径的 OAuth 回调此前都返回 500。第一次修复把抛异常的schema.parse()换成safeParsePR #103但并非根因真正的原因是自定义 Honocompose()从未把 handler 返回的Response赋给 context导致所有提前 return 都被丢弃PR #104。此外文档 AI 助手现在会升级到完整文档索引而非在索引视图上直接拒绝PR #105issues 应用在启动时校验 Vuetify One 会话使有效登录不再显示为已登出PR #79。July 2026 Changelog原文档在折叠区details中给出了完整变更日志此处完整收录。关键改进Shadow DOM修正列表、对话框与字段的键盘导航与焦点解析。Defaults封堵围绕 teleported menu 与 dialog 内容的两处继承泄漏。Select 家族多选事件、焦点行为与原生表单提交。虚拟滚动项裁剪、可见项重算与展开行滚动抖动。RTL 与 localeKurdish RTL 解析、VBtn letter-spacing、VOtpInput 焦点方向。可访问性VTreeview aria 属性与键盘导航v3 上 VDataTable 的aria-sort与选择标签。 Features以下四项组件特性均随 v3.13.0 发布v4 对应版本合入dev等待 v4.2.0VSelect/VAutocomplete/VCombobox多选新事件PR #23038commit45079af。VSkeletonLoader新增typesprop 并重新引入table-cellPR #23037commitb5d380b。VSkeletonLoader新增chip-group类型commit06cbc10。VBtnGroup新增sizeprop 对齐独立按钮commit9b46baa。VDataTable新增 mobile header 插槽——v3.13.0PR #21429。VDataTable可排序列新增aria-sort——v3.13.0commit25c0f0f。VDataTable选择控件新增 aria-labels——v3.13.0commitdb186fc。 Bug Fixes完整列表按 commit/PR 号VNumberInput解析前剥离分组分隔符94e94a9。VProgressLinear、VIconBtn避免 Vite v8 丢弃 transition timingf23af8a。VTextField与 counter 共存时尊重hide-detailsautoPR #22620。elevationhover-elevationprop 不应要求elevation378f593。VAutocomplete、VCombobox为 prepend icon 与 avatar 驼峰化 item props8a20623。v-tooltip正确处理true与undefinedcef88bf。defaults避免父级配置泄漏进 menu 与 dialog 内容PR #23016。VStepperWindow/VTouch仅在 touchHandlers 非空时移除PR #23030。VStepperVerticalItem移除 step 内容上多余的 error 颜色fce4eaa。v-touch响应绑定值变化937a471。VSelect/VAutocomplete/VCombobox带选择时的可靠列表PR #23029。VListItem/VChip/VDatePickerHeader仅在交互时挂载 clickPR #23028。VDialog/VFieldShadow DOM 中正确的焦点解析PR #23027。VDialog将自动聚焦推迟到内部字段可聚焦时8908e7e。VList开放 Shadow DOM 内的键盘导航解析PR #23024。VAutocomplete、VCombobox、VSelect原生表单提交改进PR #23022。VSelect首次点击外部释放焦点ff966d2。VSelect仅当菜单由键盘打开时聚焦第一项4bb9151。defaultsteleport 重置后保留嵌套根级 defaultsPR #23015。VDataTableVirtual修复展开行的滚动抖动PR #23014。VVirtualScroll底部追加时裁剪前导项1ac7cb7。VVirtualScroll在 updateOffsets 之后调用 calculateVisibleItemsPR #22938。VOverlay正确处理 target 赋值的 transition propPR #22190。VImg处理被 Nuxt 页面过渡延迟的 image ref0f72baf。VMaskInput在选区上粘贴时保留值PR #23003。VCalendar新增缺失的 interval propsPR #23000。VCalendar自定义 intervals 时阻止跨天小时4e36892。VTreeview确保 children 使用 toRawPR #22640。VTreeview更多 aria 属性与正确的键盘导航PR #22903。types在产出的声明文件中保留 RouteLocationRawd4d7b4b。VSwitch在 Sass 中解析 inset thumb 缩放比例86fcfaa。VDataTable移动视图下隐藏空表头单元格a759055。VOverlay非激活 overlay 跳过 click-outside DOM 扫描74e297f。VMenu修正嵌套菜单的关闭级联5902e09。VMenu内容尺寸变化时修正 click-outside 检测007f546。VNumberInput接受非 ASCII 负号6063d7a。VNumberInputprecision 为 null 时保留全部小数87b0e57。date修正 StringDateAdapter 的 locale83ed8d4。themeprovideTheme current 应使用 computedThemesPR #22987。VDateInput从 date adapter locale 派生显示格式PR #22976。VDateInputblur 时不再填充 rangeb7569fe。VAutocompleteIME 组合期间不触发 keydown 监听器PR #22974。VDataTable隐藏带自定义过滤器的列后保持行可见PR #22971。VSelect/VAutocomplete/VCombobox尊重 no-auto-scrolladb2597。rounded将 2xl、3xl 等翻译为对应 class0ea03f4。VOtpInputRTL 模式下正确移动焦点f0145aa。VDataTable对 align 为 start 的列应用 text-align02f5f81。locale正确将 Kurdish locale 解析为 RTL4782312。VBtnRTL locale 下不应用 letter-spacing3956c08。 Documentation新增 Vuetify0 1.0 公告announcing-vuetify0-v1.mdPR #23025与 RC 公告announcing-vuetify0-rc.mdPR #22981。更新路线图并宣布 v3.13.0 进入 LTScommit8306637。清理过时内容并将 LTS 重定向到根域名commite3fb29d。新增/.well-known/security.txtPR #23010。新增 VMenu 示例PR #19710、VTreeview footer 插槽示例、VDataTable fixed-footer 示例。新增 silver 赞助商层级。展望8 月回归特性8 月将回归特性开发。v4.2.0 里程碑定于9 月 1 日——MD3 按钮对齐、VSlider 的pill变体、VTimePicker 键盘控制、VMaskInput 动态 mask 都在其队列中。v4.1 补丁线会继续在底层保持运行。随着 Vuetify0 1.0 发布、其 API 在 1.x 全系受 semver 锁定框架的theme、locale与date迁移有了不再变动的落点——这些分支自春季起就在等待如今终于有了可依赖的稳定目标。对开发者的三个核心提示仍在 v3 的用户v3.13.0 是最后一个 v3 minorLTS 时钟运行至 2027 年 7 月 27 日且窗口已从 18 个月缩短为 12 个月请按新数字核对迁移计划从 upgrade-guide.md 开始。Vuetify0 用户vuetify/v0已稳定且无需任何 tag直接pnpm add vuetify/v0即可MCP server 需升级到 0.8.0 以上才能看到 1.0 的 API 表面。想从终端查看发布说明使用npx vuetify release-notes支持v0与--version参数。上述版本号、发布节奏与修复清单均以仓库内 july-2026-update.md 原文及对应源码如 VSkeletonLoader.tsx、VBtnGroup.tsx为准历史月度更新可继续查阅 packages/docs/src/pages/en/blog/ 目录下的其他月份文档。【免费下载链接】vuetify Vue Component Framework项目地址: https://gitcode.com/gh_mirrors/vu/vuetify创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考