用途:面向 Vue 3 的调试与错误处理,帮助定位和修复运行时错误、警告、异步失败以及 SSR/水合(hydration)问题。开发最佳实践与常见陷阱请改用 vue-best-practices。
主要能力:按主题组织常见问题与排查方向,包括响应式(意外重渲染、ref 缺少 .value、解构 reactive 后失去响应、集合中的 ref、模板 ref 解包、代理身份比较、markRaw、同 tick 批处理)、computed(副作用、只读返回值、条件依赖、数组变更、传参)、watchers(异步清理、异步创建泄漏、reactive 属性 getter、watchEffect 异步依赖追踪、flush 时机、deep 同引用、模板 ref 的 post flush)、组件(局部组件作用域、自定义组件点击事件、defineExpose、DOM 内模板解析、命名冲突、多根组件 class 透传)、props/emits、模板(表达式限制、v-if 空值顺序、动态参数、v-else 位置、v-if 与 v-for 混用、v-for key、range 从 1 开始、v-show 限制)、模板 ref、表单与 v-model(忽略 HTML 属性、textarea 插值、iOS select、defineModel 同步、IME 组合输入、number 修饰符、checkbox 提交)、事件修饰符、生命周期、插槽、provide/inject、attrs、composables、Composition API、动画、TypeScript、异步组件、渲染函数、KeepAlive、Transition、Teleport、Suspense、SSR、性能、SFC、插件、应用配置等。
使用方式:按症状在对应主题下查找条目,例如“ref 值不更新”查看 ref-value-access,“水合不一致”查看 ssr-hydration-mismatch-causes。资料未提供具体安装命令或代码示例。
适用场景:Vue 3 项目开发与排错,尤其是响应式、生命周期、SSR 与构建工具相关问题。
限制:资料仅列出问题索引与指向条目,未提供完整修复代码、版本要求或收费信息,具体实现需结合官方文档。