| 层级 | 当前方案 | 版本 | 状态 |
|---|---|---|---|
| UI 框架 | AdminLTE + Bootstrap | Bootstrap 3.3.7 | EOL 2019 |
| JS 库 | jQuery | 3.7.0 | 活跃 但现代化项目已减少依赖 |
| 模块加载 | RequireJS (AMD) | — | 过时 ES Modules 已是标准 |
| 表格组件 | Bootstrap Table | 1.11.5 | 旧版 当前最新 1.22+ |
| 弹窗 | FastAdmin Layer | 3.5.1 | 活跃 |
| 图表 | ECharts | 4.x | 活跃 |
| 模板引擎 | Art-Template (服务端) + ThinkPHP | 3.1.3 | 旧版 |
| 构建工具 | 无 | — | 缺失 |
| 包管理 | Bower | — | 已废弃 官方建议迁移到 npm/Yarn |
| CSS 预处理 | Less | — | 可用 |
7 个页面使用 <iframe> 加载内容。iframe 内页面拥有独立 DOM 和 JS 上下文:
506 个 HTML 模板中,大多数是标准 CRUD 页面,结构几乎完全一致:
<div class="panel panel-default panel-intro">
{:build_heading()}
<div class="panel-body">
<div id="myTabContent" class="tab-content">
<div class="tab-pane fade active in" id="one">
<div class="widget-body no-padding">
<div id="toolbar" class="toolbar">
<a ... class="btn-refresh"> <a ... class="btn-add">
<a ... class="btn-edit"> <a ... class="btn-del">
</div>
<table id="table" ...>
</div>
</div>
</div>
</div>
</div>
这种模式的页面估计占 80%+。每新增一个 CRUD 都要复制整段 HTML + 一份 JS 控制器。
至少 15 个页面的 HTML 模板中包含 <style> 块。典型如:
dashboard/index.html — 617 行,内嵌大量统计卡片 CSSuser/user/index.html — 内嵌 IP 查询下拉菜单样式video/videolist/* — 多处内嵌页面特定样式这些样式不受 Less 编译管理,难以维护和统一。
$.ajax({async:false}) 同步获取用户类型列表和渠道列表,阻塞页面渲染。应改为异步 + Promise 并行加载。Layer.confirm() 和 layer.alert() 混用,错误提示有时用 Toastr 有时用 layer.msg(),不统一。build_heading) 是服务端渲染方式生成 HTML,缺少前端动态表单能力 (字段联动、实时校验预览)。| 问题 | 表现 |
|---|---|
| 双重滚动条 | 父页面和 iframe 各自有滚动条,操作不便 |
| 弹窗层级 | iframe 内弹窗无法超出 iframe 边界,大型表单被裁剪 |
| 快捷键失效 | Ctrl+S、Esc 等快捷键无法传递到 iframe |
| 加载空白 | iframe 加载期间显示白屏,无骨架屏或进度指示 |
首次访问管理后台时,RequireJS 按依赖链串行加载模块:
require.min.js (20KB)
→ jquery.min.js (88KB)
→ bootstrap.min.js (40KB)
→ backend.js (依赖 fast + template + moment)
→ fast.js、template.js、moment.js
→ 各页面控制器 (user.js: ~400 行)
→ bootstrap-table.js、selectpage.js、layer.js...
虽然 RequireJS 有异步加载能力,但深层依赖链导致首屏需要 15-30 个 HTTP 请求。
| 资源 | 体积 | 问题 |
|---|---|---|
assets/libs/ | 28 MB | 包含未使用的库,无 Tree-Shaking |
fastadmin.css | 5,906 行 | 大量未使用样式 (AdminLTE 全量引入) |
backend.css | 1,644 行 | 与 fastadmin.css 有重叠 |
echarts.min.js | ~1MB | 全量引入,未按需加载 |
bootstrap.min.css | 120KB | Bootstrap 3 全量,大量未使用组件样式 |
| 缺失 | 影响 |
|---|---|
| Gzip/Brotli 压缩 | assets.zip 存在但未自动化 |
| CDN 加速 | 所有资源从同域加载 |
| 资源指纹 (Hash) | 版本号 ?v=xxx 使用站点版本而非文件 Hash,缓存失效不精确 |
| 懒加载 | ECharts、富文本编辑器等重型库在不需要的页面也加载 |
| 预加载/预连接 | 无 <link rel="preload"> 或 dns-prefetch |
布局使用了 sidebar-mini 和 sidebar-collapse,但:
bootstrap-table-mobile 也只是简单隐藏列| 问题 | 详情 |
|---|---|
| 文件过大 | user.js 约 400 行,包含表格配置、事件绑定、导出逻辑、批量操作等 |
| 注释代码堆积 | 大量被注释掉的旧代码(列定义、导出逻辑),与后端 PHP 代码问题一致 |
| 内联 HTML | ip-query-dropdown 的 HTML 通过 JS 字符串拼接生成,不易维护 |
| 同步 AJAX | 2 处 async: false 阻塞页面 |
| 无错误处理 | AJAX 请求多数无 error 回调 |
| 硬编码 URL | API 路径硬编码,无统一前缀管理 |
每个 CRUD 页面需要:1 个 HTML 模板 + 1 个 JS 控制器 + 1 个 PHP 控制器。三者高度耦合但各自独立维护,修改一个字段需要同时改三处。
| 组件 | 当前 | 建议 | 迁移难度 |
|---|---|---|---|
| JS 框架 | jQuery + RequireJS | Vue 3 (渐进式,可共存) | 中 |
| UI 框架 | Bootstrap 3 + AdminLTE | Element Plus 或 Naive UI | 中 |
| 构建工具 | 无 | Vite | 低 |
| 包管理 | Bower | pnpm | 低 |
| 表格 | Bootstrap Table | Element Plus Table / VxeTable | 中 |
| CSS | Less | UnoCSS / Tailwind CSS | 低 |
| 状态管理 | 无 | Pinia | 低 |
| 图表 | ECharts 4 | ECharts 5 (按需引入) | 低 |
| 阶段 | 内容 | 工期 | 效果 |
|---|---|---|---|
| Phase 1: 底座升级 | 引入 Vite 构建;CSS 切换到 UnoCSS;jQuery 现有页面不变,Vue 页面嵌入 iframe 反向过渡 | 2 周 | 开发体验提升,热更新,CSS 体积减少 80% |
| Phase 2: 核心页面迁移 | Dashboard → Vue 重写;用户列表 → Element Plus Table;支付记录 → 新表格组件 | 4 周 | 最高频页面交互升级,表格性能大幅提升 |
| Phase 3: 全量迁移 | 剩余 CRUD 页面逐步迁移;iframe 替换为 Vue Router;统一状态管理 | 6 周 | 移除 jQuery + RequireJS 依赖,统一技术栈 |
Vue 应用部署为独立前端项目,通过反向代理与 PHP 后端共存:
# Nginx 配置
location /admin/ {
# 新 Vue 管理后台
root /var/www/admin-frontend/dist;
try_files $uri /index.html;
}
location /admin/api/ {
# 旧 PHP API (不变)
proxy_pass http://php-backend;
}
PHP 后端 API 无需任何修改,Vue 前端通过 axios 调用现有接口。新老页面通过 URL 区分,互不影响。
| # | 优化项 | 工作量 | 收益 |
|---|---|---|---|
| 1 | 启用 Gzip 压缩静态资源 (Nginx gzip on) | 10 分钟 | CSS/JS 体积减少 60-70% |
| 2 | 为静态资源设置长缓存 (1年) + 版本号 | 20 分钟 | 二次访问秒开 |
| 3 | 移除 $.ajax({async:false}) 改为 Promise.all | 1 小时 | 页面渲染不阻塞 |
| 4 | 内联 <style> 迁移到 Less 文件并编译 | 2 小时 | 样式统一管理,支持压缩 |
| 5 | 注释掉的 JS 代码清理 | 2 小时 | 减少文件体积,提高可读性 |
| 6 | 为高频 API 添加加载骨架屏 (Skeleton) | 4 小时 | 感知性能提升 |
| 7 | ECharts 按需引入 (仅引入使用的图表类型) | 1 小时 | echarts.min.js 减少 40% |
| 8 | 添加 favicon + PWA manifest | 1 小时 | 品牌化 + 可安装 |
| 9 | 表格列默认隐藏低频列,提供列选择器 | 3 小时 | 用户列表等高频页体验大幅提升 |
| 10 | Ctrl+S 快捷键 (当前页面的 Save 按钮) | 1 小时 | 运营效率 |
报告生成: 2026-07-08 | 分析范围: /home/project/houtai/app.zgddj.com | 框架: FastAdmin (ThinkPHP 5)
基于静态代码分析生成。Quick Wins 项目建议立即实施。