Pinia 本身不支持自动导入，但可通过 unplugin-auto-import 插件实现 Store 自动导入；需配置 imports 包含 'pinia'、dirs 指向 store 目录，并遵守 useXxxStore 命名规范。
Pinia 本身不提供自动导入能力，但结合 Vite 生态中的 unplugin-auto-import 插件，可以实现 Store 的自动导入，避免在每个组件里反复写 import { useXXXStore } from '@/store/xxx'。
安装并配置 unplugin-auto-import
该插件支持自动导入 Vue、Vue Router、Pinia 等常用 API 和自定义 Store，无需手动 import。
- 安装插件：
pnpm add -D unplugin-auto-import - 在
vite.config.ts中添加配置：
unplugin-vue-components 使用效果更完整，但本问题聚焦 Store 自动导入）
import AutoImport from 'unplugin-auto-import/vite'
export default defineConfig({
plugins: [
// 其他插件...
AutoImport({
imports: [
'vue',
'vue-router',
'pinia', // 自动导入 useStore、defineStore 等 Pinia 核心 API
],
dts: './src/auto-imports.d.ts', // 生成类型声明文件，保障 TS 提示
dirs: ['./src/store'], // 指定 store 目录，自动扫描并导入所有 defineStore 创建的 Store
vueTemplate: true, // 支持在 .vue 模板中也自动导入（如 setup script 中的解构）
}),
],
})
Store 文件命名与导出规范
插件通过扫描 dirs 下的文件，识别 defineStore 调用并提取导出名。为确保正确导入，建议遵守以下约定：
- 每个 Store 文件只导出一个
defineStore实例（推荐） - 文件名即 Store 名（如
user.ts→useUserStore），便于记忆和调试 - 导出必须是具名导出，且函数名以
use开头（这是插件默认识别规则）
✅ 正确示例（src/store/user.ts）：
import { defineStore } from 'pinia'
export const useUserStore = defineStore('user', {
state: () => ({ token: '' }),
})
✅ 在组件中可直接使用，无需 import：
<script setup> const userStore = useUserStore() // 自动识别并导入 console.log(userStore.token) </script>
配合 TypeScript 类型安全
启用 dts: './src/auto-imports.d.ts' 后，Vite 会自动生成类型声明，VSCode 可正常提示 Store 类型、state 和 actions。若发现类型丢失，检查：
-
tsconfig.json中是否包含"types": ["./src/auto-imports.d.ts"] - Store 文件中是否正确标注了泛型（如
defineStore<string, State, {}, Actions>） - 重启 VSCode 或运行
pnpm run dev触发重新生成声明文件
注意事项与常见问题
自动导入不是“魔法”，它依赖静态分析，因此有明确边界：
- 不支持动态 Store 名（如
defineStore(name, ...)中name是变量） - 不支持多个 Store 合并在一个文件中导出（插件仅识别首个
defineStore） - 若 Store 依赖其他模块（如 API 函数），这些依赖仍需手动 import 或通过插件
imports配置补充 - 首次配置后需重启开发服务器，否则类型提示可能不生效
