Vue3外部类用ref报Cannot create property 'value' on boolean 'false'解决方法

Cannot create property 'value' on boolean 'false' 报错的本质是：你调用.value赋值的目标不是Vue的ref实例，是原始布尔值false。

你提到的setup返回ref自动解包规则只在模板渲染、reactive对象嵌套ref这两个场景生效，外部普通JS/TS类中使用ref不会触发自动解包，这部分认知没有问题，错误出在ref的传递链路。

• 先在报错的赋值行前加调试代码确认目标变量类型，isRef是Vue官方提供的ref类型判断工具，直接从vue包导入即可：

import { isRef } from 'vue'
// 你原本执行xxx.value = 赋值操作的位置，先插入调试打印
console.log('当前目标变量值：', 待赋值的目标变量, '是否为ref实例：', isRef(待赋值的目标变量))

• 如果打印结果显示不是ref，顺着变量传递路径逐段排查：
  • 检查组件向外部类传参时，传入的是不是ref本身，不要传ref变量.value这种解包后的原始值
  • 检查外部类接收、存储ref的逻辑，不要在初始化类属性时提前取.value存成普通值，要直接存ref实例本身，后续修改时再走.value
  • 检查是否存在同名变量覆盖，比如类内部定义了同名布尔类型属性，覆盖了传入的ref实例
• 如果确认拿到的是普通布尔值，直接赋值即可，不需要加.value；只有ref实例才需要通过.value修改值。

内容的提问来源于stack exchange，提问作者Andrew Rusinas