统一的项目规范是团队协作的基础。良好的规范能够降低沟通成本、减少潜在错误、提升代码的可维护性和可读性。

本文从项目结构、命名规则、Java 日志规范三个维度，梳理软件开发中的核心工程规范。

1. 项目结构

以下为项目根目录下的文件和目录的推荐组织结构：

project-root/
├── codes/             # 代码目录
├── configurations/    # 配置目录
├── demos/             # 示例目录
├── docs/              # 文档目录
├── libs/              # 第三方库文件
├── scripts/           # 脚本目录
├── packages/          # 打包文件目录
├── .gitignore         # Git 忽略规则
├── .gitattributes     # Git 属性规则
├── .editorconfig      # 编辑器书写规则
├── README.md          # 项目说明文件
└── LICENSE            # 开源协议

技术文档是软件工程中不可或缺的组成部分。规范的文档不仅能降低团队协作的沟通成本，还能提升产品的可维护性和用户体验。

本文从标题、文本、段落、数值、符号、结构、Emoji 等七个维度，系统梳理技术文档的写作规范。

📚 “参考” Markdown 语法可以参考：

• https://github.com/guodongxiaren/README
• https://github.com/tchapi/markdown-cheatsheet

在信息爆炸的时代，每个人都积累了大量的文件、资料和数据。如果没有一套科学合理的目录分类体系，文件管理很容易陷入混乱，查找资料时如同大海捞针。

良好的目录管理不仅能提升个人工作效率，还能帮助构建清晰的知识体系。本文将从目录结构设计、命名规范、存储策略和工具推荐四个方面，系统阐述个人目录管理的最佳实践。

1. 目录结构设计

1.1. 设计原则

• MECE 原则：目录之间应做到「相互独立，完全穷尽」，避免分类重叠或遗漏。
• 三层定位：任何一个文件，最多通过三级目录即可定位到，减少查找路径。
• 使用频率优先：高频使用的文件放在浅层目录或置顶，低频文件可以放在深层目录。
• 定期清理：每隔一段时间（如季度末），对临时文件和过期文件进行归档或清理。