WebStorm 中 useRouter/useRoute 不提示需依次检查：启用 Vue.js 插件、注入 Vue.js 语言、配置 Volar、显式声明 lang="ts"、确保 tsconfig.json 包含 "vue-router" 类型、标记 node_modules 为 Not Excluded。
Vue Router 的 useRouter 和 useRoute 不提示？先确认插件和语言注入
WebStorm 默认不自动识别 Vue Router 的组合式 API，哪怕你装了 vue-router@4，useRouter 依然可能标红或无补全——这不是代码写错了，是 IDE 没“认出”这是 Vue Router 的上下文。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 确保已安装并启用
Vue.js插件（Settings → Plugins → 搜索 “Vue.js”，勾选并重启） - 打开任意
.vue文件，在<script setup>区域内右键 → Inject language or reference → 选Vue.js（不是 JavaScript！） - 如果项目用 TypeScript，还需确认
node_modules/vue-router下有完整类型声明（index.d.ts），Volar 插件比默认 TS 服务更可靠，建议启用：Settings → Languages & Frameworks → TypeScript → Vue.js → Use Volar instead of built-in service
defineProps 和 defineEmits 报错“cannot find name”？检查脚本 lang 属性和编译器配置
这是 Vue 3 组合式 API 最常见的“假报错”：代码能跑，IDE 却标红。根本原因是 WebStorm 没把 <script setup> 当作支持新语法的模块处理。
实操建议：
立即学习“前端免费学习笔记（深入）”；
-
<script setup lang="ts">中的lang="ts"必须显式写出，不能省略；若用 JS，则写lang="ts"会直接失败 - 确认项目根目录存在
tsconfig.json，且"compilerOptions": { "types": ["vue", "vue-router"] }已包含（尤其缺vue-router时useRouter就没类型） - 删掉
.idea目录 + 重启 WebStorm，强制重建索引（别跳过这步，旧缓存常卡住类型解析）
为什么 router.push 有提示但参数没类型？补全依赖 vue-router 的类型导出
你可能看到 router.push 函数名有高亮、有跳转，但鼠标悬停没参数说明，传对象时也无字段提示——这说明类型定义加载了，但没被正确推导或注入。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 在
src/router/index.ts中，确保导出的是createRouter实例，且返回类型明确：export const router = createRouter({...}) as Router（加类型断言可提升稳定性） - 在组件中不要直接 import
router，而是用useRouter()—— WebStorm 对useRouter的类型推断强于直接导入实例 - 若仍无参数提示，检查
node_modules/vue-router/dist/vue-router.d.ts是否可读；某些 pnpm 或 workspace 场景下路径解析异常，可临时在shims-vue.d.ts中加一行：/// <reference types="vue-router" />
配置完还是不生效？重点排查 node_modules 是否被误标为 Excluded
这是最隐蔽也最高频的坑：WebStorm 把整个 node_modules 标成了 “Excluded”，导致所有类型声明、插件注入全部失效，连 ref 都不提示，更别说 useRouter。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 在项目视图中右键点击
node_modules文件夹 → Mark Directory as → 确保选的是Not Excluded（不是 “Excluded” 也不是 “Sources Root”） - 标记后等待右下角索引进度条走完（可能需 1–3 分钟），别急着关窗口
- 如仍异常，终端执行
rm -rf .idea，再用 WebStorm 重新打开项目根目录（不是子文件夹）
复杂点在于：这些配置项彼此耦合，比如 Volar 关闭了、lang="ts" 漏写了、node_modules 又被 exclude 了——三个问题同时存在时，只修一个根本看不出变化。
