四、代码风格规范

四、代码风格规范

目标：
保证所有代码在任何时间、任何人看来，都能像同一个人写的一样。
风格一致 = 降低认知成本、减少 Bug、提升协作效率。

---

4.1 缩进与格式化

✅ 规范：

• 统一使用 4 个空格缩进（不使用 Tab）。
• 每级逻辑嵌套必须缩进，保持代码结构清晰。
• 同一项目中不得混用 Tab 与空格。

💡 示例：

# 正确
def calc_total(price, count):total = price * countreturn total# 错误
def calc_total(price, count):total = price * countreturn total

---

4.2 换行与行宽

✅ 规范：

• 每行代码不超过 100 个字符（Google / 阿里标准均为 100）。
• 超长表达式请使用 括号换行 + 缩进对齐。
• 逻辑块之间空一行，保持视觉分层。

💡 示例：

# ✅ 推荐写法
total = (order.price+ order.tax+ order.shipping_fee
)# ❌ 不推荐
total = order.price + order.tax + order.shipping_fee +