Petua Python untuk Menjadikan Kod Anda Bersinar! ✨

Kod bersih adalah penting untuk menjadikan aplikasi Python boleh diurus dan berskala. Python menghargai kebolehbacaan, oleh itu membangunkan kod bersih adalah sangat penting. Dalam siaran ini, saya akan membentangkan sepuluh idea untuk menulis kod Python yang lebih bersih sambil meningkatkan kebolehbacaan, kecekapan dan kebolehselenggaraan. Jom mulakan:

1. Gunakan Pembolehubah Bermakna dan Nama Fungsi

Dalam Python, nama pembolehubah harus mencerminkan tujuannya. Elakkan pembolehubah satu aksara atau nama samar-samar.

• Amalan Buruk:

x = 10

• Amalan Baik:

item_count = 10

2. Pastikan Fungsi Kecil dan Fokus

Python membolehkan fleksibiliti, tetapi amalan terbaik untuk memastikan fungsi anda kecil dan fokus. Setiap fungsi perlu melakukan satu perkara.

• Amalan Buruk:

def process_data():
    fetch_data()
    validate_data()
    save_data()

• Amalan Baik:

def fetch_data():
    pass

def validate_data():
    pass

def save_data():
    pass

3. Gunakan Pemformatan Konsisten

Inden adalah penting dalam Python, kerana ia mentakrifkan blok kod. Berpegang pada 4 ruang setiap tahap lekukan (standard PEP 8). Gaya yang konsisten menjadikan kod anda lebih mudah untuk diikuti.

• Amalan Buruk:

if x:
    print("Hello")
else:
print("Goodbye")

• Amalan Baik:

if x:
    print("Hello")
else:
    print("Goodbye")

4. Elakkan Nombor Ajaib

Elakkan menggunakan nombor sembarangan terus dalam kod. Sebaliknya, gunakan pemalar dengan nama deskriptif.

• Amalan Buruk:

area = 3.14 * radius * radius

• Amalan Baik:

PI = 3.14
area = PI * radius * radius

5. Gunakan Parameter Lalai

Python membenarkan nilai lalai untuk parameter fungsi. Ini mengurangkan keperluan untuk bersyarat dan menjadikan fungsi anda lebih ringkas.

• Amalan Buruk:

def greet(name):
    if not name:
        name = 'Guest'
    print(f"Hello {name}")

• Amalan Baik:

def greet(name="Guest"):
    print(f"Hello {name}")

6. Minimumkan Gelung Bersarang dan Syarat

Kebolehbacaan Python mengalami terlalu banyak sarang. Kurangkan bersarang dengan pulangan awal atau dengan memecahkan logik kepada fungsi yang lebih kecil.

• Amalan Buruk:

if x:
    if y:
        if z:
            print("Condition met!")

• Amalan Baik:

if not x or not y or not z:
    return
print("Condition met!")

7. Manfaatkan Fungsi Terbina Dalam Python

Python menawarkan fungsi dan perpustakaan terbina dalam yang berkuasa. Untuk tugas biasa, gunakan alatan terbina dalam ini daripada menulis logik anda.

• Amalan Buruk:

x = 10

• Amalan Baik:

item_count = 10

8. Elakkan Pembolehubah Global

Dalam Python, pembolehubah global boleh membawa kepada tingkah laku yang tidak dijangka dan menyukarkan penyahpepijatan. Simpan pembolehubah dalam fungsi, atau gunakan kelas jika perlu.

• Amalan Buruk:

def process_data():
    fetch_data()
    validate_data()
    save_data()

• Amalan Baik:

def fetch_data():
    pass

def validate_data():
    pass

def save_data():
    pass

9. Gunakan Pemahaman Senarai

Pemahaman senarai ialah cara Pythonic untuk membuat senarai. Ia padat, mudah dibaca dan lebih cekap daripada menggunakan gelung.

• Amalan Buruk:

if x:
    print("Hello")
else:
print("Goodbye")

• Amalan Baik:

if x:
    print("Hello")
else:
    print("Goodbye")

10. Tulis Komen dan Dokumen Rentetan

Pembangun Python bergantung pada rentetan dan ulasan untuk dokumentasi. Walaupun kod itu sendiri harus jelas, gunakan docstrings untuk menerangkan fungsi dan kelas serta tambah ulasan apabila logik adalah kompleks.

• Amalan Buruk:

area = 3.14 * radius * radius

• Amalan Baik:

PI = 3.14
area = PI * radius * radius

11. Tangani Pengecualian Dengan Betul

Daripada membiarkan program anda ranap apabila berlaku masalah, kendalikan pengecualian dengan betul. Ia meningkatkan kestabilan kod anda.

• Amalan Buruk:

def greet(name):
    if not name:
        name = 'Guest'
    print(f"Hello {name}")

• Amalan Baik:

def greet(name="Guest"):
    print(f"Hello {name}")

12. Elakkan Menggunakan args dan *kwargs Tanpa Perlu

Walaupun *args dan **kwargs berkuasa, mereka harus digunakan dengan bijak. Menggunakannya secara tidak perlu boleh membuat panggilan fungsi anda mengelirukan.

• Amalan Buruk:

if x:
    if y:
        if z:
            print("Condition met!")

• Amalan Baik:

if not x or not y or not z:
    return
print("Condition met!")

13. Gunakan Petua Jenis

Menambah petunjuk jenis menjadikan kod lebih mudah difahami dan membantu alatan seperti linter dan IDE memberikan bantuan yang lebih baik.

• Amalan Buruk:

squared_numbers = []
for num in range(1, 6):
    squared_numbers.append(num ** 2)

• Amalan Baik:

squared_numbers = [num ** 2 for num in range(1, 6)]

14. Hadkan Kesan Sampingan dalam Fungsi

Kesan sampingan (mis., mengubah suai pembolehubah global atau keadaan objek) boleh menjadikan kod lebih sukar untuk difahami. Cuba kurangkan dan pastikan fungsi tulen, apabila boleh.

• Amalan Buruk:

counter = 0
def increment():
    global counter
    counter += 1

• Amalan Baik:

class Counter:
    def __init__(self):
        self.counter = 0

    def increment(self):
        self.counter += 1

15. Gunakan Python dengan Pernyataan untuk Pengurusan Sumber

Mengurus sumber seperti fail, pangkalan data atau sambungan rangkaian, gunakan pernyataan dengan untuk memastikan ia ditutup atau dibersihkan dengan betul.

• Amalan Buruk:

x = 10

• Amalan Baik:

item_count = 10

16. Elakkan Menggunakan eval()

eval() boleh berbahaya kerana ia melaksanakan kod arbitrari. Ia selalunya tidak perlu dan harus dielakkan atas sebab keselamatan.

• Amalan Buruk:

def process_data():
    fetch_data()
    validate_data()
    save_data()

• Amalan Baik:

def fetch_data():
    pass

def validate_data():
    pass

def save_data():
    pass

17. Elakkan Pengulangan (Prinsip KERING)

Don’t Repeat Yourself (DRY) ialah prinsip yang menggalakkan penggunaan fungsi, kelas atau abstraksi lain untuk mengelakkan kod berlebihan.

• Amalan Buruk:

if x:
    print("Hello")
else:
print("Goodbye")

• Amalan Baik:

if x:
    print("Hello")
else:
    print("Goodbye")

18. Gunakan Enumerate Daripada Julat

Apabila menggelungkan senarai dan memerlukan kedua-dua indeks dan item, gunakan enumerate() untuk mengelakkan pengindeksan manual.

• Amalan Buruk:

area = 3.14 * radius * radius

• Amalan Baik:

PI = 3.14
area = PI * radius * radius

19. Kumpulan Kod Berkaitan Ke Dalam Kelas

Jika kod anda mempunyai fungsi yang berkaitan, selalunya idea yang baik untuk mengumpulkannya ke dalam kelas. Ini merangkumi tingkah laku yang berkaitan dan menjadikan kod lebih teratur.

• Amalan Buruk:

def greet(name):
    if not name:
        name = 'Guest'
    print(f"Hello {name}")

• Amalan Baik:

def greet(name="Guest"):
    print(f"Hello {name}")

Menulis kod bersih dalam Python bukan hanya tentang mengikuti amalan terbaik—ia mengenai menjadikan kod anda mudah dibaca, diselenggara dan skala. Dengan menggunakan petua ini, anda akan terus menulis kod Python yang cekap dan bersih. Matlamatnya adalah untuk memastikan kod anda mudah, boleh dibaca dan cekap serta sentiasa berusaha untuk mengikuti falsafah teras Python: Kiraan kebolehbacaan.

Apakah petua yang anda gunakan untuk memastikan kod Python anda bersih? Kongsi pendapat anda dalam komen!

---

Selepas hampir dua tahun menjadi MIA, saya kembali dalam permainan! Bersedia untuk menyelami Python dengan Django, dan kali ini, saya membawa blog itu bersama-sama. Kencangkan—ia akan menjadi perjalanan yang bergelombang (dan mudah-mudahan tidak terlalu banyak kereta). Mari belajar, ketawa dan buat beberapa keajaiban berlaku!

Atas ialah kandungan terperinci Petua Python untuk Menjadikan Kod Anda Bersinar! ✨. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!