---
title: "开发经验与项目规范整理文档"
type: source
tags: []
date: 2025-12-30
---

## Source File
- [[raw/Vibe Coding/开发经验与项目规范整理文档.md]]

## Summary
- 核心主题：软件开发经验与项目规范整理
- 问题域：代码组织、命名规范、架构设计、最佳实践
- 方法/机制：通过统一变量索引、文件结构规范、编码风格指导、系统架构原则实现高质量代码管理
- 结论/价值：提供可操作的开发规范，帮助团队和 AI 维护一致性的代码质量

## Key Claims
- 统一的变量索引文件可降低命名冲突和语义不清晰的风险
- 遵循小写英文+下划线或小驼峰的文件命名规则可提升代码可读性
- 单一职责原则要求每个文件、类、函数只负责一件事
- 微服务架构通过服务拆分实现独立开发、独立部署、独立扩容

## Key Quotes
> "编程的第一步永远是：你要解决什么问题？"

> "复杂问题拆解为可独立完成的小单元。"

> "你写的代码是给别人理解的，不是来炫技的。"

> "注释解释'为什么'，不是'怎么做'。"

## Key Concepts
- [[单一职责]]：一个函数只处理一个任务
- [[DRY 原则]]：避免重复代码，提炼公共逻辑
- [[微服务]]：独立开发、独立部署、独立扩容的架构模式
- [[Redis]]：缓存提升读性能，降低数据库压力
- [[消息队列]]：用于服务间异步通信，实现解耦和削峰填谷

## Key Entities
- （无特定人物或公司）

## Connections
- [[Vibe Coding]] ← 指导 ← [[开发经验与项目规范整理文档]]
- [[OpenCode]] ← 工具 ← [[Vibe Coding]]
- [[Vibe-Kanban]] ← 工具 ← [[Vibe Coding]]

## Contradictions
- （暂无冲突）