Web_Template_Vue3_Dev/AI-Coding/Pitfalls.md

已知陷阱与迁移雷区（Pitfalls）

• 生产环境禁调试：src/App.vue 使用 disable-devtool，可能影响某些测试/调试环境。
• 生产环境默认 Mock：src/main.ts 中存在“生产启用 mockXHR”的逻辑，做真实项目发布时要确认策略。
• 配置入口：vue.config.js 通过 require('./src/config') 读取配置；src/config/index.js 会聚合导出多个子配置。
• 自动插件加载：library/index.ts 会 require.context('./plugins', true, /\\.ts$/) 全量加载；抽取模块时容易带入不需要依赖。

对应的约束与处理建议：见 openspec-lite/project.yaml。