第一步：启用浏览器开发者工具定位报错
这是排查所有前端JS问题的核心前置操作，没有工具辅助根本找不到问题根源，必须优先完成。
Windows/Mac通用操作（Chrome/Edge/Firefox）
- 打开浏览器访问你的苹果CMS页面（不要在后台编辑器，必须访问真实前端展示页）
- Windows按F12键；Mac按Command+Option+I键
- 点击顶部Console（控制台）标签
- 控制台显示红色文字即为JS报错，重点关注以下3个信息：
- 报错描述：最核心，告诉你为什么错（比如ReferenceError: $ is not defined、Uncaught TypeError: a is not a function）
- 错误文件路径：报错右侧的.js文件名+行号（比如template/default/static/js/video.js:234）
- 错误堆栈：点击展开报错可以看到调用链，复杂问题时有用
必做准备：如果苹果CMS后台开启了“JS压缩合并”或“静态缓存”，先临时关闭——后台→系统→网站参数配置→性能优化→取消勾选静态资源压缩合并→取消勾选全站静态缓存→点击“保存配置”→刷新前端页。
第二步：苹果CMS高频JS报错分类修复
这里整理了苹果CMS 90%以上会遇到的JS报错，按Console报错直接对应即可。
高频报错1：ReferenceError: $ is not defined
报错原因：苹果CMS的JS功能99%依赖jQuery库，页面加载顺序错了——模板文件先加载了业务JS，后加载jQuery；或者jQuery根本没引入。
精准修复步骤
- 打开苹果CMS后台→模板→模板管理→找到你正在用的模板→点击修改头部文件（一般是header.html或top.html）
- 检查头部是否有jQuery引入代码，正确位置（业务JS之前）的引入格式是：
- 模板自带本地jQuery：
- CDN引入（推荐，加载更快）：
- 关键调整：将jQuery引入代码放在所有业务JS（比如player.js、index.js）的最前面，位置一般在标签之前
- 点击“保存文件”→刷新前端页验证报错是否消失
高频报错2：Uncaught TypeError: macPlayer.init is not a function
报错原因：播放器业务JS文件macPlayer.js未引入、引入路径错误、或者静态资源压缩后顺序乱了。
精准修复步骤
- 临时关闭后台“静态资源压缩合并”“全站静态缓存”（已关跳过）
- 打开苹果CMS后台→模板→模板管理→找到正在用的模板→检查底部文件（一般是footer.html）
- 正确引入格式（本地/CDN二选一，本地优先）：
- 关键顺序：macPlayer.js必须放在jQuery之后、播放器初始化代码之前
- 播放器初始化代码一般是这样的（放在视频详情页show.html或footer.html最后）：
```html
```
- 点击“保存文件”→刷新视频详情页验证
高频报错3：Uncaught SyntaxError: Unexpected token '}' or '<' or 'string'
报错原因：模板文件（特别是JS代码块）里多了/少了括号、引号、大括号，或者PHP标签写错（比如{if写成if{）。
精准修复步骤
- 打开浏览器开发者工具Console，找到报错右侧的文件路径+行号（比如template/default/static/js/index.js:45或template/default/show.html:123）
- 如果是.js文件报错：
- 打开苹果CMS后台→模板→文件管理→找到对应目录的对应JS文件→点击“修改”
- 跳转到报错行号（很多编辑器有Ctrl+G跳转到行功能）
- 检查该行及上一行的括号、引号是否成对，比如用单引号时不能中途混双引号（除非转义\''或\"\"）
- 如果是.html文件报错：
- 同样后台找到对应HTML文件→修改→跳转到行号
- 检查HTML里的
