# 已知陷阱与迁移雷区（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](openspec-lite/project.yaml)。