getCurrentInstance() 是 Vue 3 组合式 API 中仅限 setup 同步调用的内部 API，用于获取组件实例，但不稳定且不推荐常规使用；应优先采用 defineProps、defineEmits 等显式 API。
在 Vue 3 组合式 API 中，getCurrentInstance() 是一个底层 API，**仅限在 setup() 函数或其调用的函数中同步使用**，用于获取当前组件的实例上下文（即 ComponentInternalInstance）。但它不是推荐的常规用法，官方文档明确标注为“内部 API”，稳定性与兼容性不保证，应谨慎使用。
什么时候可能需要 getCurrentInstance
多数场景下，你应该优先使用 defineProps、defineEmits、useSlots、useAttrs 等显式 API。只有极少数情况才考虑它，例如：
- 在自定义 Hook 中需要访问组件的
proxy（即 this）来触发事件或调用方法（但更推荐通过参数传入 emit 或 context） - 需要读取组件的
vnode、type、parent等内部属性（如开发高级工具库、调试器、渲染逻辑封装） - 在 setup 中动态调用
expose暴露的方法（但 expose 本身已提供更安全的方式）
如何正确调用 getCurrentInstance
必须在 setup() 执行期间同步调用，不能在异步回调（如 setTimeout、Promise.then）、事件处理函数或 computed getter 中使用，否则返回 null。
示例：
立即学习“前端免费学习笔记（深入）”；
import { defineComponent, getCurrentInstance } from 'vue'
export default defineComponent({
setup() {
const instance = getCurrentInstance()
if (instance) {
console.log('当前组件名：', instance.type.name)
console.log('父组件实例：', instance.parent)
console.log('暴露给父组件的 proxy：', instance.proxy) // ⚠️ proxy 已被废弃，仅兼容旧写法
}
return () => <div>hello</div>
}
})
替代 getCurrentInstance 的推荐方式
绝大多数原本想通过 instance 实现的功能，都有更稳定、更语义化的组合式 API 替代：
- 要触发事件 → 使用
const emit = defineEmits(['update:modelValue'])，然后emit('update:modelValue', value) - 要访问插槽 → 使用
const slots = useSlots() - 要访问透传属性 → 使用
const attrs = useAttrs() - 要获取组件暴露的方法 → 在
setup()中用defineExpose({ method })，由父组件通过 ref 调用 - 要访问路由或 store → 使用
useRouter()、useRoute()、useStore()等官方组合式 API
注意事项和风险
不要在生产环境依赖 getCurrentInstance 的返回值结构 —— 它的属性（如 proxy、data、propsData）属于内部实现，Vue 未来版本可能移除或重命名。
如果在非 setup 同步上下文中调用（比如在 onMounted 回调里直接调），也可能返回 null；若需在生命周期钩子中使用，应确保在 setup 内部保存 instance 引用：
setup() {
const instance = getCurrentInstance()
onMounted(() => {
if (instance) {
console.log('mounted with instance:', instance.uid)
}
})
return {}
}
