核心原因是PhpStorm未正确识别.vue文件：必须启用Vue.js插件并重启，将*.vue绑定至Vue.js Template类型，且需手动注入template/script语言；TypeScript项目还需tsconfig.json含"types": ["vue"]及本地安装@vue/runtime-dom。
ref标红、v-if没提示、defineProps报“Unresolved function”——不是代码写错了，是 PhpStorm 根本没把 .vue 文件当 Vue 处理。核心就两点：插件没启用，或文件类型绑错。
Vue.js 插件必须手动启用且重启才生效
PhpStorm 不像 WebStorm 那样默认带 Vue 支持。Vue.js 插件（注意不是 Volar，也不是 Vue Language Features (Builtin)）必须显式安装并启用，且重启 IDE 才能加载语言服务。
- 进
Settings / Preferences → Plugins，搜Vue.js，确认状态为Enabled - 如果是
Install，点它，然后必须重启 PhpStorm —— 光点Apply或OK不起作用 - 重启后验证：打开任意
.vue文件，左侧图标应变成 Vue Logo；File → New菜单里应出现Vue File模板
文件类型必须绑定为 Vue.js Template
插件装了，但单个 .vue 文件还是灰的、<script setup></script> 里 ref 还是标红？大概率是 PhpStorm 把它当成了 HTML 或纯文本——不是语法问题，是“认错人”了。
- 进
Settings / Preferences → Editor → File Types - 在
Recognized File Types列表中找到Vue.js Template - 在
Registered Patterns下添加*.vue（若已存在，先删掉其他类型如HTML Files对*.vue的注册） - 改完不生效？右键该文件 →
Override File Type → Vue.js Template，或关闭再重开文件
语言注入没开，<template></template> 和 <script></script> 块就是纯文本
即使文件类型对了，<template></template> 里写 v-for 没补全、<script setup></script> 里 defineProps 仍标红，说明语言注入没启用——PhpStorm 默认不会自动识别块级语法。
vue-component-analyzer
下载
递归分析 Vue 项目组件依赖，从入口文件生成组件层级图，支持 Vue 2/3，输出组件名、文件路径和属性。适用于分析组件结构、排查依赖或了解项目架构。
立即学习“PHP免费学习笔记（深入）”；
- 右键
<template></template>标签 →Inject language or reference → HTML - 右键
<script></script>标签 →Inject language or reference → JavaScript（或TypeScript，取决于你用的脚本类型） - 一劳永逸：进
Settings → Editor → Language Injections，加规则：对script[type="text/javascript"]和template标签自动注入对应语言 - 如果用了
<script setup lang="ts"></script>，必须注入TypeScript，否则组合式 API 无法识别
TypeScript + Vue 3 场景下类型推导断链的常见卡点
高亮有了，但 ref 是蓝色、count 变量也是蓝色——说明只有基础语法着色，缺语义层。根本原因是 PhpStorm 没读到 tsconfig.json 或类型定义未加载。
- 项目根目录必须有
tsconfig.json，且含"types": ["vue"]或["vue", "@vue/runtime-dom"] - 确保已安装
@vue/runtime-dom（仅devDependencies不够，PhpStorm 会扫描node_modules实际内容） - 进
Settings → Languages & Frameworks → JavaScript → Libraries，确认node_modules/@vue被标记为Library - 检查
Settings → Editor → Color Scheme → TypeScript是否勾选了Enable semantic highlighting
最易被忽略的是：所有配置都对了，但 Power Save Mode 被误开了——右下角电池图标一亮，所有后台分析（包括类型推导、跳转、补全）立刻停摆，关掉几秒就恢复，别绕路查插件。
