peixue-dev/Archive/peidu-temp-files/docs/[一次性]家长端首页按钮图标路径修复-2026-01-26.md

5.0 KiB
Raw Blame History

家长端首页按钮图标路径修复

时间: 2026-01-26
状态: 已完成


📋 任务说明

修复家长端首页功能按钮的图标路径,确保所有图标都能正确加载。


🔍 问题发现

图标文件位置

D:\project\peixu\peidu\uniapp\static\button\

文件列表

  1. 陪伴员.jpg
  2. 暑假营.jpg
  3. 测评师.jpg
  4. 成长规划师.jpg ← 注意文件名
  5. 家长学院.jpg
  6. 一对一陪伴.jpg
  7. 研学活动.jpg
  8. 专项突破.jpg
  9. 兴趣培养.jpg
  10. 线上督学.jpg

路径不匹配问题

代码中的路径:

{ id: 4, icon: '/static/button/规划师.jpg', label: '成长规划师' }

实际文件名:

成长规划师.jpg

路径不匹配,导致图标无法加载!


🔧 修复方案

修改前

{ id: 4, icon: '/static/button/规划师.jpg', label: '成长规划师' }

修改后

{ id: 4, icon: '/static/button/成长规划师.jpg', label: '成长规划师' }

完整配置

文件: peidu/uniapp/src/pages/index/components/UserHome.vue

functionIcons: [
  // 第一行
  { id: 1, icon: '/static/button/陪伴员.jpg', label: '陪伴员', path: '/pages/teacher/list' },
  { id: 2, icon: '/static/button/暑假营.jpg', label: '暑假营', path: '/activity-package/pages/camp/list' },
  { id: 3, icon: '/static/button/测评师.jpg', label: '测评师', path: '/service-package/pages/assessment/index' },
  { id: 4, icon: '/static/button/成长规划师.jpg', label: '成长规划师', path: '/service-package/pages/planning/index' },
  { id: 5, icon: '/static/button/家长学院.jpg', label: '家长学院', path: '/activity-package/pages/academy/index' },
  
  // 第二行
  { id: 6, icon: '/static/button/一对一陪伴.jpg', label: '一对一陪伴', path: '/pages/service/list', params: { category: '基准式陪伴' } },
  { id: 7, icon: '/static/button/研学活动.jpg', label: '研学活动', path: '/activity-package/pages/study-tour/category' },
  { id: 8, icon: '/static/button/专项突破.jpg', label: '专项突破', path: '/service-package/pages/special/list' },
  { id: 9, icon: '/static/button/兴趣培养.jpg', label: '兴趣培养', path: '/activity-package/pages/interest/category' },
  { id: 10, icon: '/static/button/线上督学.jpg', label: '线上督学', path: '/activity-package/pages/supervision/category' }
]

🎨 按钮布局

家长端首页按钮采用 2行×5列 的网格布局:

第一行:
┌──────────┬──────────┬──────────┬──────────────┬──────────┐
│  陪伴员  │  暑假营  │  测评师  │ 成长规划师   │ 家长学院 │
└──────────┴──────────┴──────────┴──────────────┴──────────┘

第二行:
┌──────────────┬──────────┬──────────┬──────────┬──────────┐
│ 一对一陪伴   │ 研学活动 │ 专项突破 │ 兴趣培养 │ 线上督学 │
└──────────────┴──────────┴──────────┴──────────┴──────────┘

🧪 测试步骤

1. 清除缓存重新编译

cd peidu/uniapp
npm run dev:mp-weixin

2. 微信开发者工具

  1. 清除缓存:工具 → 清除缓存 → 清除全部缓存
  2. 重新编译:编译 → 重新编译
  3. 查看家长端首页

3. 检查要点

  • 10个按钮图标全部显示
  • 图标清晰,无模糊
  • 特别检查"成长规划师"按钮图标是否正常显示
  • 点击按钮能正常跳转

📊 图标文件信息

图标目录结构

peidu/uniapp/static/button/
├── 陪伴员.jpg
├── 暑假营.jpg
├── 测评师.jpg
├── 成长规划师.jpg          ← 修复的文件
├── 家长学院.jpg
├── 一对一陪伴.jpg
├── 研学活动.jpg
├── 专项突破.jpg
├── 兴趣培养.jpg
└── 线上督学.jpg

路径规范

正确的路径格式:

icon: '/static/button/文件名.jpg'

注意事项:

  1. 路径以 /static/ 开头(绝对路径)
  2. 文件名必须与实际文件完全一致(包括中文字符)
  3. 文件扩展名必须正确(.jpg

📌 相关文件

  • 图标目录:peidu/uniapp/static/button/
  • 首页组件:peidu/uniapp/src/pages/index/components/UserHome.vue
  • 图标配置:functionIcons 数组

修复总结

  1. 发现路径不匹配问题:规划师.jpg vs 成长规划师.jpg
  2. 修正图标路径配置
  3. 确认所有10个按钮图标路径正确
  4. 准备测试验证

完成时间: 2026-01-26 17:35