Pinia 的 useStore 无法被 VSCode 原生自动导入，因其依赖运行时 defineStore 动态创建，TS 无法静态推导名称；必须通过 unplugin-auto-import 扫描 src/stores/ 目录、生成 auto-imports.d.ts 并配合 Volar、正确 tsconfig 配置，才能实现 useXXXStore 的智能提示与自动导入。
Pinia 的 useStore 函数无法靠 VSCode 原生能力自动导入，必须配合 unplugin-auto-import 插件 + 正确配置才能实现。 单纯依赖 VSCode 的 IntelliSense 或 Auto Import 插件，在 Store 文件未被识别为“可导入目标”时，useXXXStore 会完全不出现 import 建议。
为什么 VSCode 默认不提示 useXXXStore 导入
VSCode 的自动导入依赖 TypeScript 语言服务对模块的静态分析。Pinia Store 是运行时动态创建的（defineStore() 返回函数），TS 无法在类型检查阶段推导出所有 useXxxStore 名称；同时，VSCode 不会主动扫描 src/stores/ 目录下的文件并将其注册为可导入项——它只认 import 语句已存在的路径或 declare module 显式声明的内容。
常见现象包括：
- 输入
useUserStore后无任何补全建议，右下角语言模式显示为vue或typescript但 Ctrl+. 也不弹“自动导入”选项 - 手动写了
import { useUserStore } from '@/stores/user'后，后续再输useUserStore才有补全，但新组件里仍要重复写 - 即使装了
Auto Import插件（steoates 版），也只对 npm 包或显式 export 的变量生效，对 Pinia Store 无效
unplugin-auto-import 配置要点（Vite + Vue3 + Pinia）
该插件会在构建时扫描指定目录，提取 export function useXxxStore 并生成一个虚拟的 auto-imports.d.ts 和 runtime 模块，让 TS 语言服务和 VSCode 能“看见”这些函数。
关键配置项（vite.config.ts）：
-
imports必须显式包含'pinia'，否则defineStore、createPinia等基础 API 不会进自动导入列表 -
dirs指向 Store 文件所在目录，如['src/stores']，且目录内文件需遵守命名规范：export function useXxxStore() - Store 文件必须用
export function语法导出（不能是const useXxxStore = defineStore(...)后再export { useXxxStore }，后者无法被插件静态识别） - 版本必须锁定：
unplugin-auto-import@19.2.0（2025 年底起，20.x 主线与 Pinia v2.1+ 兼容稳定；21.x 在部分 Vite 4.5+ 场景下会漏扫 Store 文件）
示例配置片段：
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'
import AutoImport from 'unplugin-auto-import/vite'
<p>export default defineConfig({
plugins: [
vue(),
AutoImport({
imports: ['pinia'],
dirs: ['src/stores'],
dts: './src/auto-imports.d.ts',
vueTemplate: true
})
]
})VSCode 能正确识别的前提条件
插件生成了声明文件，但 VSCode 还得“读得懂”。以下任一缺失都会导致 Ctrl+. 不弹、输入无提示：
- 项目根目录必须存在
tsconfig.json（哪怕只有{}），否则 TS 语言服务不启动 -
tsconfig.json中需包含"include": ["src/**/*.ts", "src/**/*.d.ts"]，确保auto-imports.d.ts被纳入检查范围 - VSCode 右下角语言模式必须是
vue（.vue 文件）或typescript（.ts 文件），不是javascript或plaintext - 不要用 Vue 官方插件（Vue - Official），必须用
Volar（v1.14+），否则<script setup>中的自动导入不生效 - 首次配置后，务必重启 TS Server：命令面板 →
Developer: Restart TS Server，否则旧缓存会忽略新生成的 .d.ts
容易被忽略的细节
最常卡住的地方不是插件没装，而是 Store 文件本身没写对：
-
src/stores/user.ts写成export const useUserStore = defineStore(...)→ 插件扫不到，必须改成export function useUserStore() { return defineStore(...)() }或更稳妥的写法：export const useUserStore = defineStore('user', {...})（注意：插件 v19.2.0 支持这种直接 export const 形式，但前提是文件扩展名是.ts，不是.store.ts） - 路径别名
@/stores在tsconfig.json中未配置"baseUrl"和"paths"，会导致插件生成的 import 路径错误（如变成../../../stores/user），虽然能跑，但 TS 报错“Cannot find module” - 用了
pinia-plugin-persistedstate但没在imports里加'pinia-plugin-persistedstate'，那么persistedState选项里的函数也不会被自动导入
配完跑一次 vite dev，看控制台是否输出 [unplugin-auto-import] generating auto-imports.d.ts —— 没这行，说明插件根本没执行，先查 vite.config.ts 是否被正确加载。
