Pinia 中 defineStore 的字符串 ID 必须全局唯一，重复将导致状态覆盖；推荐用模块前缀（如 'admin/user'）或 import.meta.url 动态生成 ID，并通过集中注册校验确保唯一性。
Pinia 中 defineStore 的名字（即第一个参数）必须全局唯一，重复会导致运行时警告甚至覆盖已有 store，引发难以排查的状态混乱。关键不是“能不能重名”，而是“必须不重名”——这是 Pinia 的设计约束。
用语义化、带作用域的命名
避免简单使用 user、cart 这类泛化名称。推荐在名字中加入模块或业务前缀：
-
useAdminUserStore()→defineStore('admin/user', {...}) -
useCheckoutCartStore()→defineStore('checkout/cart', {...}) -
useDashboardAnalyticsStore()→defineStore('dashboard/analytics', {...})
斜杠分隔符虽非强制，但能直观体现层级关系，也兼容 DevTools 中的分组显示。
利用文件路径自动生成唯一 ID（推荐）
借助构建工具（如 Vite）的 import.meta.url 或 __filename，在开发阶段动态生成 store ID，彻底规避手动命名冲突：
import { defineStore } from 'pinia'
<p>export const useUserStore = defineStore(
import.meta.url, // Vite 下每个模块 URL 唯一
{
state: () => ({ name: '' }),
}
)这种方式无需记忆命名规则，适合中大型项目或团队协作。注意：生产环境仍需确保 ID 稳定（Vite 默认已处理），若用 Webpack，可改用 __filename 或 __dirname + '/user.ts'。
统一注册入口 + 命名检查（工程化防护）
在 store 入口文件（如 stores/index.ts）集中导入并注册所有 store，并添加运行时校验：
import { createPinia } from 'pinia'
import * as userStoreModule from './user'
import * as cartStoreModule from './cart'
<p>const pinia = createPinia()
const storeModules = [userStoreModule, cartStoreModule]</p><p>// 检查重复 ID
const ids = new Set<string>()
storeModules.forEach((mod) => {
const store = mod.useUserStore || mod.useCartStore // 根据导出名调整
if (ids.has(store.$id)) {
throw new Error(<code>Store ID conflict: ${store.$id}</code>)
}
ids.add(store.$id)
pinia.use(store)
})配合 ESLint 插件或 CI 脚本做静态扫描，可提前拦截命名问题。
别把 store 名和组合式函数名搞混
useUserStore 是组合式函数名，可以复用（比如多个模块都导出同名函数）；真正不能重复的是 defineStore('xxx') 中的字符串 ID。只要 ID 唯一，哪怕写成：
export const useUserStore = defineStore('admin/user', {...})export const useUserStore = defineStore('member/user', {...})
也是完全合法的——它们是两个独立 store，只是组合式函数名碰巧一样（实际项目中建议还是区分开，避免混淆）。
