班级优化大师功能使用教程电子版

网站 localStorage 存储数据后无法读取

1. 检查存储的键名是否正确，无拼写错误或大小写不一致；2. 修复数据读取逻辑，确保正确反序列化（如 JSON.parse）；3. 核实浏览器是否开启隐私模式（隐私模式下 localStorage 可能受限）；4. 检查存储数据大小是否超过限制，清理无用数据

网站 OCR 识别功能失效

1. 检查 OCR 接口是否正常，配置是否正确；2. 核实图片是否清晰，符合识别要求；3. 修复图片上传逻辑，确保格式 / 尺寸正确；4. 处理识别错误，提供手动输入备选

网站表单输入框输入时自动联想内容错误

1. 检查自动联想功能的数据源是否正确，无错误数据；2. 修复联想匹配逻辑，确保关键词与联想结果相关；3. 核实是否启用了浏览器自带的自动填充，干扰自定义联想；4. 提供联想结果删除功能，清理错误联想内容

网站前端脚本加载阻塞页面渲染

1. 对 CSS/JS 文件进行压缩和合并，减少文件体积；2. 采用异步加载（async）或延迟加载（defer）JavaScript；3. 调整脚本加载顺序，优先加载关键渲染资源；4. 移除冗余脚本，避免不必要的第三方库引入

网站导出 Excel 文件打开乱码

1. 设置 Excel 文件编码为 UTF-8+BOM；2. 确保导出数据格式正确，无特殊字符；3. 修复 Excel 文件头设置，指定正确的 MIME 类型；4. 测试不同 Excel 版本，确保兼容

网站搜索框输入关键词后搜索结果无排序

1. 检查搜索接口是否默认启用排序规则（如按相关性）；2. 修复排序参数传递，确保默认排序方式生效；3. 核实搜索算法是否支持排序，无排序逻辑缺失；4. 提供手动排序选项（如按时间、热度），提升用户体验

网站日期选择器无法选择过去日期

1. 检查日期选择器的 minDate 配置，是否限制了可选范围；2. 修复日期范围逻辑，根据业务需求调整过去日期限制；3. 确保日期选择器插件支持过去日期选择，无默认限制；4. 测试不同日期格式，排查格式不兼容问题

网站后台管理页面加载缓慢

1. 优化后台查询逻辑，减少数据加载量；2. 压缩后台静态资源（CSS/JS/ 图片）；3. 分页加载后台数据，避免一次性加载过多；4. 关闭后台不必要的日志输出，提升响应速度

网站第三方统计工具数据不显示

1. 检查统计代码是否正确嵌入，无语法错误；2. 核实统计工具的站点 ID / 配置是否正确；3. 确保统计代码在页面加载完成前执行，无异步阻塞；4. 排查广告拦截插件是否屏蔽了统计域名