
核心亮点
- 中英文双语,导航栏一键切换
- 五阶段课程成长路线,从启蒙到竞技逐级评估
- 3 片户外硬地场,日/夜场分时定价与在线咨询
- ITF/PTR 认证教练团队,教练履历与擅长技术可视化
- SEO 完整(结构化数据 + sitemap + 404 兜底),移动端全断点适配
技术栈
产品界面
开发成果 12/12
- 项目立项,Vue 3 + Vite 架构搭建
- 首页骨架(Hero / 关于我们 / 数据统计 / 联系方式)
- 明星教练页与教练履历展示
- 活动资讯页(春季网球赛 / 夏令营 / 周年庆)
- 课程体系五阶段成长路线页
- 课程咨询页与套餐卡片
- 场地预定页与日/夜场分时价格
- 图片资源本地化(中文文件名转英文、去 Unsplash 外链)
- 滚动动画与移动端响应式适配
- SEO 优化(meta / OG / JSON-LD / sitemap / robots / 404 兜底)
- 中英文双语国际化(vue-i18n)
- 部署上线腾讯云 CloudBase 静态托管
开发历程 12 条
部署上线腾讯云 CloudBase 静态托管
- npm run build → deploy.js → cloudbase hosting deploy dist,站点上线 CloudBase 静态托管。
- vite.config.js 配 base: './' 适配静态托管子路径。
- 收尾给关键文件补中文注释,注明组件功能、数据结构与设计决策。
- 已知:默认测试域名首次访问有提示页需点确定;子路径无 SPA fallback,直接访问会 404。
修复 i18n 取数组返回 key 路径:t() 改 tm()
- 现象:切语言后标签、设施清单等列表被 v-for 拆成 key 路径字符串。
- 根因:vue-i18n v9 的 t() 只返回字符串,数组/对象值会回退成 key 路径。
- 修复:取数组或对象统一改 tm() 并加 || [] 兜底,涉及 6 个文件;约定 t() 管字符串、tm() 管数组对象。
- 附带修复:联系我们锚点被 70px 固定导航遮挡,加 scroll-margin-top: 80px。
中英文双语完整的国际化(vue-i18n@9)实施
- 引入 vue-i18n@9,建 src/i18n/,zh-CN 与 en 两包约 200+ key。
- key 按页面/组件分命名空间,导航、首页、教练、课程、场地预约等各一组。
- 自动检测浏览器语言 + localStorage 持久化,Navbar 加中/EN 切换;硬编码中文改 $t(),ref 数据用 computed + t()。
- 管理调试页不做国际化;修切换按钮白字看不见,改深色字 + 绿色 active。
SEO 优化:结构化数据 + 懒加载路由 + 404 兜底
- index.html 补 description / keywords / theme-color、Open Graph、Twitter Cards、JSON-LD(LocalBusiness)、preconnect。
- 新增 robots.txt 与 sitemap.xml。
- 路由全量懒加载,每路由带 meta,beforeEach 同步 title 与 OG 标签。
- 新增 NotFound 页与 :pathMatch(.*)* 兜底,删除脚手架残留 style.css。
踩坑:scroll-reveal 双层嵌套导致内容 opacity:0 不显示
- 现象:加滚动动画后首页课程体系整块 opacity:0 不显示。
- 根因:About/Coaches/Courses/Moments/Contact 五个组件模板自带 .scroll-reveal,Home.vue 又包一层,内层永远不被 IntersectionObserver 观察到。
- 修复:移除组件内 class、动画统一由 Home 控制;CSS 动画挂 html.sr-ready 前缀做渐进增强,useScrollReveal 加 nextTick。
- 同类坑:子页面根元素也不能加 .scroll-reveal,否则整页不显示。
滚动揭示动画 + 移动端响应式适配
- 新建 useScrollReveal.js,基于 IntersectionObserver 做滚动触发。
- style.css 加方向变体、data-reveal-delay 1~6 交错延迟、prefers-reduced-motion 降级。
- 子页面卡片改为每张独立滚动显示,避免整块空白等待;断点 768px 与 480px 适配,按钮 min-height 44px。
- 教练竖图高度 240→360px,配 object-fit: cover 与 center top,修掉只露下半张脸。
首页 Hero 可读性优化:黑色半透明毛玻璃文字框
- Hero 大图上白字与背景重叠,部分文字几乎看不清。
- 方案一改绿字对比度不够,已弃用。
- 最终给 .hero-content 加 rgba(0,0,0,0.35) 半透明底、圆角 20px、blur(4px) 毛玻璃,内边距 40/50px。
- 结论:大字压图加半透明底比改字色靠谱。
新增场地预定页,全站购买入口统一为「立刻咨询」
- 新建 VenueBooking.vue:3 片场地卡片 + 设施标签 + 日夜场价格 + 营业时间 06:00-00:00 + 预定须知。
- 价格:1/2 号场日场 100、夜场 150,3 号场日场 80、夜场 120。
- 3 号场类型由红土场修正为户外硬地场。
- 购买入口全改「立刻咨询」,新增 useContactAction:PC 跳联系我们锚点,手机直接拨号。




