Nuxt 3中useRoute提示找不到名称但可正常使用的问题排查

我在使用Nuxt 3.6.1时遇到一个问题：在<script setup lang="ts">中调用useRoute()时，编辑器提示“Cannot Find name useRoute”，但代码实际运行正常。更奇怪的是，useRoute在pages/index.vue里能正常自动补全，但在pages目录下的其他文件或子目录中就会触发这个错误提示。

代码示例：

<script lang="ts" setup>
const routes = useRoute();
</script>

<template>
</template>

package.json依赖版本：

{
  "devDependencies": {
    "@nuxt/devtools": "latest",
    "@types/node": "^18",
    "nuxt": "^3.6.1"
  },
  "dependencies": {
    "@nuxt/image": "^1.0.0-rc.1",
    "@nuxtjs/tailwindcss": "^6.8.0",
    "@vuepic/vue-datepicker": "^5.3.0",
    "nuxt-icon": "^0.4.1",
    "nuxt-swiper": "^1.1.1"
  }
}

解决办法 #

• 重启TypeScript服务：在VS Code中打开命令面板（Ctrl+Shift+P），输入TypeScript: Restart TS Server执行，等待服务重启后再检查提示。
• 重新生成类型文件：执行npx nuxi prepare或npm run prepare命令，让Nuxt重新生成项目的类型定义文件。
• 切换编辑器TypeScript版本：确保编辑器使用项目本地的TypeScript版本，而非全局版本。在VS Code中可点击右下角的TypeScript版本标识，选择Use Workspace Version。
• 清除缓存：删除项目根目录下的.nuxt和.output文件夹，然后重新运行npm run dev，让Nuxt重新生成所有配置文件。

内容的提问来源于stack exchange，提问作者GianPierre Gálvez