Code Simplifier

提供代码简化、重构和优化的原则指导。

核心原则

函数设计

• 单一职责: 每个函数只做一件事
• 长度控制: 目标 < 50 行，理想 10-30 行
• 参数控制: ≤ 4 个参数；超过时使用数据类或配置对象
• 早期返回: 用 guard clauses 避免深层嵌套

代码组织

• DRY: 提取重复逻辑为公共函数
• 命名清晰: 变量名反映意图，避免单字母（循环变量除外）
• 无魔法数字: 提取为命名常量
• 嵌套控制: 嵌套层级 ≤ 3 层

错误处理

• 捕获具体异常，不使用裸

  except:

• 保留原始异常链 (

  raise ... from e

  )
• 使用 context manager 管理资源

语言特定规范

Python

# ✅ 类型注解
def process(user_id: int, data: dict) -> dict | None:
    ...

# ✅ list/dict comprehension（避免嵌套）
result = [x for x in items if x.condition]

# ✅ 命名
snake_case（变量/函数）, PascalCase（类）, UPPER_SNAKE_CASE（常量）

# ❌ 避免
# - 嵌套 comprehension
# - 过度使用 lambda
# - 裸 except:

JavaScript / TypeScript

// ✅ const/let，无 var
// ✅ 箭头函数
const process = (data) => data.filter(x => x.valid);

// ✅ 解构
const { name, email } = user;

// ✅ 命名
camelCase（变量/函数）, PascalCase（类/接口）, UPPER_SNAKE_CASE（常量）

质量检查清单

函数级别

• 函数长度 < 50 行
• 嵌套层级 < 3 层
• 单一职责
• 命名有意义

代码级别

• 无重复代码
• 无魔法数字
• 无未使用变量/导入
• 错误处理具体

整体质量

• 符合语言规范
• 类型注解/标注完整
• 可读性良好
• 易于维护

参考文档

• 重构模式: refactoring_patterns.md — Early Return、Extract Method、Guard Clauses、Async/Await 等 20+ 模式
• 最佳实践: best-practices.md — 函数设计、代码组织、错误处理、性能优化、测试友好设计
• 故障排除: troubleshooting.md — 代码异味诊断、复杂度分析、自动化工具、重构工作流