--- title: "开发经验与项目规范整理文档" type: source tags: [开发, 规范, 编码, 微服务] date: 2026-04-14 source_file: raw/Technical/开发经验与项目规范整理文档.md --- ## Summary - 核心主题:软件开发规范与最佳实践 - 问题域:变量命名、文件结构、编码规范、系统架构 - 方法/机制:建立统一索引 → 明确输入输出 → 遵循单一职责 - 结论/价值:工程化思维减少复杂度、提高可维护性 ## Key Claims - 变量名大全文件:统一变量命名,方便全局搜索和AI管理 - 文件结构:每个子目录包含agents和claude.md说明文档 - 编码规范:消费端/生产端/状态/变换明确划分 - 系统架构原则:先梳理清架构,再写代码 - 程序设计核心:需求 → 简单架构 → 可维护测试 → 小步迭代 - DRY原则:提炼公共逻辑,避免重复代码 ## Key Concepts - [[变量命名规范]]:小写英文+下划线或小驼峰,语义化 - [[单一职责]]:每个文件/类/函数只负责一件事 - [[输入输出划分]]:消费端/生产端/状态/变换 - [[DRY原则]]:Don't Repeat Yourself,不重复代码 - [[微服务架构]]:独立开发、独立部署、独立扩容 ## Key Entities - [[Redis]]:缓存、提升读性能、降低数据库压力 - [[消息队列]]:异步通信、解耦、削峰填谷 ## Connections - [[Trae远程开发部署指南]] ← 开发实践 ← [[开发经验与规范]] ## Contradictions - 尚未发现