namespaced是Vuex多模块隔离的核心机制，必须显式设为true才能启用；调用时需加模块前缀，跨模块通信应通过getter或带{root:true}的commit/action解耦，动态注册模块也须始终启用namespaced。
命名空间（namespaced）是 Vuex 多模块管理的核心机制，开启后能彻底隔离模块的 state、getters、mutations 和 actions，避免命名冲突，也强制你显式声明调用路径——这既是约束，也是清晰性的保障。但很多同学开了 namespaced 却仍写错调用方式，或在跨模块通信时绕弯子、硬耦合，反而让代码更难维护。
一、namespaced 必须设为 true 才真正启用隔离
很多人只在模块里写了 namespaced: true，却忘了：它只对当前模块生效，且必须显式开启。如果漏写或写成 namespaced: false（默认值），那这个模块的所有接口都会注册到全局命名空间，极易和其它模块或根模块同名方法冲突。
正确写法示例：
// store/modules/user.js
export default {
namespaced: true, // ✅ 必须显式设为 true
state: () => ({ token: '' }),
mutations: {
SET_TOKEN(state, token) {
state.token = token
}
},
actions: {
login({ commit }, payload) {
commit('SET_TOKEN', payload.token)
}
}
}
二、带命名空间的调用必须加前缀，不能“偷懒”省略
开启 namespaced 后，所有访问都需带上模块名。Vuex 不会自动降级查找，也不会帮你“猜”你在哪个模块——这是设计使然，不是 bug。
立即学习“前端免费学习笔记（深入）”；
常见错误写法：
从零开始编排 SpringBoot+Vue 全栈项目工作流，适用于新建全栈项目或完整脚手架请求，触发后依次调用 product‑spec‑builder（需求调研）等模块。
- 在组件中直接 this.$store.dispatch('login') → ❌ 报错：找不到全局 action
- 在另一个模块的 action 中写 commit('user/SET_TOKEN') → ❌ 错误：mutation 名应为 'user/SET_TOKEN'，但 commit 默认不支持斜杠路径（除非手动拼接）
正确方式：
- 组件内：this.$store.dispatch('user/login')、this.$store.commit('user/SET_TOKEN')
- 模块内跨调用（如 order 模块想改 user 状态）：commit('user/SET_TOKEN', token, { root: true })（注意 { root: true } 表示从根上下文出发解析路径）
- 使用 mapXXX 辅助函数时，必须传入命名空间字符串：mapActions('user', ['login'])
三、跨模块通信别硬传 state，优先用 getter + commit/action 解耦
遇到“订单模块需要用户权限”“购物车要读用户登录态”这类场景，不要在 order.js 里直接 import userStore 或 this.$store.state.user —— 这会造成模块强依赖，测试困难，重构易崩。
推荐做法：
- 在 user 模块暴露 getter：isLogin: state => !!state.token
- order 模块通过 this.$store.getters['user/isLogin'] 读取（安全、可缓存、响应式）
- 如需触发用户侧逻辑（如登录后自动拉购物车），在 login action 末尾 dispatch 一个全局事件型 action（如 'app/afterLogin'），由 app 模块统一协调，而非 order 主动监听
四、动态注册模块？记得 always namespaced: true
用 store.registerModule('cart', cartModule) 动态加载时，模块对象仍需包含 namespaced: true。否则注册进去的模块会污染全局空间，且无法被正常卸载清理。
额外提醒：
- 动态模块的命名空间路径就是注册时传入的 key（如 'cart'），不要和文件名混淆
- 卸载用 store.unregisterModule('cart')，它只对 namespaced 模块有效；非 namespaced 模块卸载后可能残留 mutation
命名空间不是语法糖，而是 Vuex 对模块边界的严肃声明。开就开到底，调就调清楚，跨就跨得有契约——这样多模块才不会变成“多雷区”。
