java如何记笔记
使用代码注释记录关键逻辑
在Java代码中直接使用单行（//）或多行注释（/* */）记录核心算法、复杂逻辑或待优化点。例如：
// 使用快速排序提升性能，时间复杂度O(n log n)
Arrays.sort(data);
/*
* 注意：此处需处理多线程并发问题
* 待优化为AtomicInteger
*/
int counter = 0;维护README与技术文档
创建项目级文档（Markdown格式）记录：
- 项目结构说明
- 模块依赖关系
- 重要API的使用示例
- 环境配置要求
示例片段：
## 核心模块 service/: 业务逻辑层dao/: 数据库访问层 需先启动ConfigLoader初始化配置
利用Javadoc生成API文档
遵循Javadoc规范编写类和方法说明，可通过javadoc命令生成HTML文档：
/
* 计算圆的面积
* @param radius 半径值（需大于0）
* @return 面积计算结果
* @throws IllegalArgumentException 当半径不合法时抛出
*/
public double calculateCircleArea(double radius) {
if(radius <= 0) throw new IllegalArgumentException();
return Math.PI * radius * radius;
}使用单元测试作为活文档
通过JUnit测试用例展示代码使用方式：
@Test
public void testCalculateCircleArea() {
Calculator calc = new Calculator();
assertEquals(3.14, calc.calculateCircleArea(1.0), 0.01);
assertThrows(IllegalArgumentException.class,
() -> calc.calculateCircleArea(-1));
}版本控制提交信息规范化
在Git等版本控制系统中提交时，采用语义化消息格式：
feat: 添加用户登录验证
fix: 修复空指针异常#123
docs: 更新数据库连接说明使用IDE内置工具
利用IntelliJ IDEA等工具的：
- 书签功能标记重要代码位置
- TODO注释自动跟踪任务（
// TODO: 需重构缓存机制） - 本地历史记录查看代码变更
建立知识图谱
使用思维导图工具（如XMind）梳理：
- 核心类关系图
- 异常处理体系
- 第三方库集成要点
- 性能调优路径
日志记录关键操作
通过日志框架记录运行时信息，补充静态文档的不足：
Logger.info("用户{}执行订单创建，参数:{}", userId, JsonUtils.toJson(request));
Logger.debug("开始处理库存扣减，商品ID:{}", skuId);
