Code Review Helper 是 IDEA 中离线轻量级代码评审最实用插件，需确保插件启用、项目方式打开、Excel 行号为纯数字且路径一致，否则易导致意见丢失或跳转错位。
Code Review Helper 是目前在 IDEA 里做离线、轻量级代码评审最实用的插件，它不依赖服务端也能用，但容易因配置错路径或忽略状态同步导致评审意见“丢了”或“对不上行”。别急着导出 Excel，先看清楚这三处关键操作点。
Code Review Helper 插件安装后没反应？检查 Settings → Plugins 是否启用
装完插件必须重启 IDEA，且重启后要确认插件已勾选启用。常见问题包括：
- 插件列表里显示已安装，但未打勾 → 手动勾选并 Apply
- 重启后仍看不到
CodeReview工具窗口 → 按Alt+Shift+7或菜单View → Tool Windows → CodeReview手动唤出 - IDEA 版本低于
2022.3→ 插件可能不兼容，建议升级到2024.1+
用 Alt+A 添加评审意见但保存失败？注意当前文件是否在项目根目录下
该插件默认把评审数据存到项目根目录下的 .code-review-data 文件夹。如果打开的是单个文件（File → Open），而非以项目方式（Open → Project）加载，Alt+A 会静默失败，无报错提示。
- 务必通过
Open → Project加载整个模块或工程 - 确认项目根目录下能生成
.code-review-data/目录（首次保存后出现） - 若使用 Git 子模块，评审数据只写入当前打开的子项目根目录，跨模块评审需分别导入导出
Excel 导出导入后跳转不到代码行？检查行号是否被格式化或含空格
导出的 Excel 表格中，lineNumber 列必须是纯数字，不能是文本格式，也不能含前后空格或换行符。否则导入时解析失败，跳转位置为空或错位。
- 导入前在 Excel 中选中
lineNumber列 → 右键 → “设置单元格格式” → 改为“数值”，小数位数设为 0 - 避免手动编辑 Excel 中的
filePath，应保持与 IDEA 中显示的相对路径完全一致（比如src/main/java/com/example/Service.java） - 导入后点击列表项无响应？鼠标悬停在行号旁图标上，看 tooltip 是否显示正确路径和行号 —— 这是判断导入是否成功的最快方式
真正难的不是加注释，而是让不同人看到同一份意见时，行号、文件路径、状态标记三者完全对齐。别跳过 .code-review-data 目录的版本管理，也别在没确认导入成功前就删掉原始 Excel —— 那是唯一能回溯的备份。
