用途：这是一份 Vue 3 的避坑与决策参考，帮助开发者在写代码前选对方案、写完后避开常见响应式陷阱。按资料，完整 Vue/Nuxt 文档应使用 Context7 查询。
关键决策：ref 用于基本类型与单一值，reactive 用于对象，不要解构 reactive，否则会丢失响应性；共享应用状态用 Pinia，组件树范围内共享用 provide/inject；始终使用 Composition API 配合 <script setup>，Options 仅用于遗留代码；始终使用 composables（use* 函数），mixins 是已废弃的模式。
主要能力与常见坑：解构 reactive() 对象会丢失响应性，应使用 toRefs() 或继续用 ref()；ref() 在模板中自动解包，但在 JS 中不会，脚本里要用 .value；watch 需要显式指定来源，watchEffect 自动追踪，需比较新旧值时用 watch；computed 是只读的，不要直接赋值，需要时用带 get/set 的可写 computed；<script setup> 会自动暴露给模板，但不会暴露给父组件的 $refs，需使用 defineExpose()；props 是只读的，不要修改，应通过事件通知父组件；同一元素上 v-for 与 v-if，Vue 3 中 v-if 优先级更高（与 Vue 2 相反）；Pinia 中解构 store 的 state/getters 要用 storeToRefs()，actions 不需要；状态变更后如需访问更新后的 DOM，需要 nextTick()。
适用场景：Vue 3 项目开发、代码评审、重构遗留 Options API 代码，以及排查响应式失效问题。限制：资料未提供具体版本号、安装命令、代码示例、收费与平台信息，均暂未提供。