代码提示不生效90%是语言服务未启动或插件未匹配vue项目类型;需先验证是否真失效(console.和

代码提示不生效,90% 是语言服务没跑起来,或插件没对上 Vue 项目类型——不是你写错了,是 HBuilderX 没认出你在写 Vue。
确认是不是真失效,别被假象骗了
先别急着删缓存。打开一个 .vue 文件,在 <script></script> 里输入 console.,看有没有 log/error 提示;再在 <template></template> 输入 <view>,看是否自动补全闭合标签。两者都无反应,才是真失效。如果只在 <code><script setup></script> 里没提示,大概率是 Volar 没接管,不是全局崩了。
重启语言服务器 + 手动切文件类型
这是最快见效的两步,覆盖大多数“忽灵忽不灵”场景:
HBuilderX 是由 DCloud 推出的一款轻量级前端开发工具,在 Linux 系统上主要用于 Web 开发与跨平台应用开发,尤其适合 Vue 和 uni-app 相关项目。
- 按
Ctrl + Shift + P打开命令面板 → 输入重启语言服务器→ 回车(强制重载 JS/Vue 语言服务进程) - 看右下角状态栏:如果显示
Plain Text或JavaScript,点击它 → 选Vue(.vue文件必须识别为 Vue 类型,否则 Volar 不启动) - 若刚从其他编辑器迁移过来,或用拖拽方式单独打开了某个
.vue文件,它默认不会加载项目级语法库——务必用“打开文件夹”方式加载整个项目根目录
Volar、TS、JS 插件缺一不可
这三个插件是 Vue 3 项目代码提示的底层支柱,禁用任意一个,this. 或 uni. 就直接静音:
- 进「扩展」→「已安装」→ 确保启用:
Volar(Vue 3 必需)、TypeScript Language Features、JavaScript Language Basics - 如果装了
Vetur,建议禁用——它和Volar冲突,尤其在<script setup></script>场景下会互相屏蔽 - 检查插件是否更新:旧版 Volar(如 v1.10 之前)对
defineProps类型推导支持不全,容易导致props.提示空白
删 .hbuilderx 文件夹比清缓存更管用
项目根目录下的 .hbuilderx 是 HBuilderX 自建的符号索引库,一旦损坏,重启或清缓存都救不回来:
- 关闭 HBuilderX
- 进入项目根目录,删除隐藏文件夹
.hbuilderx - 重新用 HBuilderX 打开该项目(不是单个文件)
- 首次打开会重建索引,等待右下角状态栏出现 “索引中…” → “就绪” 后再测试提示
这个步骤常被忽略,但它解决的是“提示完全不触发”的硬伤,比反复点「清理缓存」有效得多。注意:它不删你的源码,只清掉编辑器私有元数据。









