项目优化建议模板

网站离线缓存不生效，无法离线访问

1. 检查 Service Worker 注册是否成功，是否缓存资源；2. 修复缓存策略，确保关键资源被缓存；3. 清除旧的 Service Worker，更新缓存；4. 测试离线状态下的页面加载，确保功能正常

网站模态框打开后表单字段值清空

1. 检查模态框初始化逻辑，是否在打开时重置了表单；2. 修复表单数据存储，确保打开模态框前保存字段值；3. 核实是否存在脚本错误导致表单重置；4. 打开模态框时重新赋值表单字段，恢复之前的输入内容

网站 API 接口版本冲突

1. 检查接口版本号是否正确，是否支持目标版本；2. 核实请求头中版本参数是否正确传递；3. 提供接口版本兼容方案，避免强制升级；4. 文档中明确版本差异，指导用户适配

网站表格排序功能失效

1. 检查排序事件监听逻辑是否正确；2. 修复排序算法，确保按选中列排序；3. 确保排序状态正确显示（升序 / 降序）；4. 测试不同数据类型（数字 / 字符串 / 日期）排序

网站模态框打开后背景滚动无法禁止

1. 打开模态框时给 body 添加 overflow: hidden 样式；2. 修复移动端触摸事件，禁止背景滚动；3. 确保模态框关闭时移除禁止滚动样式；4. 处理 iOS 系统的弹性滚动问题，添加额外兼容代码

网站富文本编辑器无法插入链接

1. 检查链接插入功能的配置，是否限制了链接协议（如仅允许 http/https）；2. 修复链接参数验证逻辑，确保 URL 格式正确；3. 核实是否存在权限限制，禁止插入外部链接；4. 处理插入后的链接样式，确保可点击、无样式遮挡

网站地图导航路线规划缺少备选方案

1. 检查地图 API 的路线规划参数，是否启用了多方案查询；2. 修复路线筛选逻辑，支持按时间、距离、费用排序；3. 核实是否存在交通管制、道路施工等影响路线的因素；4. 提示用户手动调整起点 / 终点，重新规划路线

网站后台管理系统权限分配后无效果

1. 检查权限分配逻辑，是否正确关联角色与菜单 / 操作；2. 修复权限校验接口，确保操作时实时校验权限；3. 核实用户是否已关联正确角色，无角色分配错误；4. 刷新权限缓存，处理权限更新延迟场景

网站语音识别无响应，无法识别语音

1. 检查麦克风权限是否开启，浏览器是否有权访问麦克风；2. 修复语音识别接口调用，确保 API 密钥有效；3. 核实录音环境是否安静，无过多背景噪音；4. 测试语音识别接口单独调用是否正常，排查前端集成问题