常见问题
组件库与后台模板的安装、接入、升级和许可问题。没找到答案可以在源码仓库提 issue。
组件库
支持 Vue 2 吗？
不支持。对等依赖是 vue ^3.4.0，只提供 Vue 3 版本。
必须用 Vite 或 Webpack 吗？
不必须。组件库是零构建 ESM，源码可直接被浏览器加载；也提供 UMD 产物，可用 script 标签通过 CDN 引入。
能用在商业项目里吗？
可以。MIT 许可，保留版权声明即可修改、分发与商用。
有 TypeScript 类型吗？
有。包内 types/index.d.ts 覆盖全部组件的属性、事件与插槽，按需引入的子路径同样带类型。
有现成的后台模板吗？
有。djm-ui-admin 单独发布，与示例应用共用同一个外壳：工作台、用户、角色、部门、岗位、字典、参数、日志、文件、相册、报表、账号、登录与异常页共 20 个，页面自带演示数据，接入时换成自己的接口，版本和组件库对齐。
支持服务端渲染吗？
服务端只渲染结构，组件挂载后才访问 DOM。SSR 场景在客户端调用 initTheme() 初始化主题。
为什么 CSP 需要 unsafe-eval？
组件用运行时模板编写，需要带编译器的 Vue 构建（vue/dist/vue.esm-bundler.js），编译过程用到 new Function，所以 script-src 要放开 'unsafe-eval'。预编译产物还在做，落地后可以收紧。
能部署在子路径下吗？
可以。组件库用相对路径，打包工具的 base 或 publicPath 配成 /followup。后台模板的 Vite 配置也读 base，登录、页签、表格都在子路径下跑过。
升级会破坏现有页面吗？
组件库的小版本只加不改，属性和事件保持兼容，删除或改名的写在 CHANGELOG 里。后台模板 0.74.0 起外壳改成 ShellLayout，页面改用 views 映射，升级前先看 CHANGELOG。
支持哪些浏览器？
Chrome、Edge、Firefox、Safari 最近两个大版本，不支持 IE。320 到 2560 逐档适配，移动端的浮层换成抽屉和全屏面板。
遇到问题怎么反馈？
在源码仓库提 issue，写清版本号、复现步骤和浏览器。附最小复现代码的最快。组件的属性和示例也能用 MCP 服务先查。
后台模板
后台模板包含演示数据吗？
包含。演示数据在 src/demo 下的 data.js、store.js、media-library.js，用来跑通页面。接入时替换成自己的字段，或按 AdminApi 实现接口后用 provideAdminApi 注入。
后台模板必须用 vue-router 吗？
不必须。壳通过 select 事件回传菜单 key，用 hash、自研路由或 vue-router 都行，切换逻辑写在你的容器里。
能只装后台模板不装组件库吗？
不能。djm-ui 和 vue 都是 peer 依赖，两个包要一起装，版本保持一致。
后台模板能部署在子路径吗？
可以。Vite 配 base，静态资源和路由都按子路径生成；history 路由需要服务器把子路径回落到 index.html。