javascript-function-style

JavaScript/TypeScript 函数风格

**这是严格的规范。**请严格遵守以下规则。

如何在 JavaScript 和 TypeScript 项目中编写函数。

---

函数声明与箭头函数

以下情况使用 function 关键字：

• 常规函数定义
• 顶层函数
• 需要提升的命名函数

以下情况使用箭头函数：

• 数组方法（.map()、.filter()、.reduce()）
• 内联回调
• React 组件属性
• 需要词法绑定 this 时

---

示例

// ✅ Regular functions
function calculateTotal(items: Item[]): number {
  return items.reduce((sum, item) => sum + item.price, 0);
}

function UserProfile({ userId }: Props) {
  return <div>{userId}</div>;
}

// ✅ Arrow functions in appropriate contexts
const numbers = [1, 2, 3].map(n => n * 2);

const handleClick = () => {
  console.log('clicked');
};

<Button onClick={() => handleSubmit()} />

---

为什么采用这种模式

• 一致性：明确的规则让代码库更具可预测性
• 可读性：函数声明更加明确
• 灵活性：在箭头函数能发挥优势时使用（简洁、词法作用域）

---

持续改进

如果开发者纠正了本规范原本应该避免的行为，请提出对本规范的具体修订建议，以避免今后再次出现同样的问题。