写代码是给人看的，机器只是顺便执行一下。写出别人能看懂的代码，比写出能跑的代码更重要——毕竟能跑的烂代码迟早会被人推翻重写。Python的设计哲学本身就强调可读性，毕竟那句“代码即文档”已经深入人心。那么，怎么写出更优雅、更容易读的Python代码？

变量命名要有意义

变量名是代码的灵魂，它决定了读代码的人要不要费脑子去猜测你的意思。

# 糟糕的命名

a = 10

b = 20

c = a + b

# 更好的命名

apple_price = 10

banana_price = 20

total_price = apple_price + banana_price

短小的变量名并不会让代码更简洁，只会让别人更迷惑。变量名应当表达出其真正的用途，而不是让人猜谜。

温馨提示：别偷懒用 temp、data、info 这种模棱两可的名字，没人能猜到它们到底存的是什么。

代码格式要清晰

Python强调缩进，那就好好利用它，别让代码像一坨浆糊。

# 糟糕的缩进，完全看不懂

if True:

print("Hello")

    print("World")

# 正确的缩进，清晰易读

if True:

    print("Hello")

    print("World")

代码对齐、适当的空行和合适的缩进，能让代码更加美观，也更容易理解。

温馨提示：Python社区推崇 4个空格 作为缩进，不要用 Tab，免得遇上不同编辑器时代码炸裂。

控制行宽，别让人滚动太多

一行代码尽量控制在 80-100 个字符 以内。长到要左右滚动的代码，阅读体验极差。

# 太长的代码，眼睛受罪

result = some_function(argument_one, argument_two, argument_three, argument_four, argument_five, argument_six)

# 合理换行，提高可读性

result = some_function(

    argument_one,

    argument_two,

    argument_three,

    argument_four,

    argument_five,

    argument_six

)

换行时，参数缩进对齐 或 多行分段 都是合理的选择，关键是看起来要舒服。

逻辑清晰，别写一行干三件事

Python代码的可读性强调一目了然，不要把太多逻辑塞进一行。

# 这是什么魔法？

users = [u for u in data if u.is_active() and u.age > 18 and not u.is_banned()]

# 分解成更清晰的逻辑

active_users = [u for u in data if u.is_active()]

adult_users = [u for u in active_users if u.age > 18]

valid_users = [u for u in adult_users if not u.is_banned()]

虽然列表推导式很酷，但不要滥用，否则别人看你的代码会想锤人。

注释要精准，别废话

代码应该尽量自解释，但该有的注释还是要有。好的注释能减少沟通成本。

# 糟糕的注释

x = 10  # 赋值10

# 有价值的注释

retry_limit = 3  # 允许的最大重试次数

温馨提示：别用注释来解释代码逻辑，代码本身就该表达清楚。注释主要用来解释 为什么这样做。

结语

代码的可读性决定了维护的成本，好的代码就像一本清晰的书，谁看都懂，谁改都轻松。写Python，不只是写能跑的代码，而是写让人舒服的代码。