Składnia Pythona: wcięcia, linie, dwukropki i zasady, które mają znaczenie

Najkrótszy możliwy regulamin

Python słynie z czytelności, a w dużej mierze wynika to z tego, jak mało zasad składni ma ten język. Te, które mają znaczenie, zmieszczą się na jednej stronie:

• Jedna instrukcja w linii.
• Wcięcia wyznaczają strukturę: bez klamer, bez słów kluczowych end.
• Wielkość liter ma znaczenie. name i Name to co innego.
• : otwiera blok; następne linie z wcięciem pod nim są ciałem bloku.
• # rozpoczyna komentarz.

To w zasadzie wszystko. Reszta to zmienne, funkcje i nawyki z biblioteki standardowej, które przyswoisz po drodze. Przejdźmy przez te pięć zasad z takim kontekstem, żeby przestały wyglądać jak zasady, a zaczęły jak naturalny kształt języka.

Jedna instrukcja w linii

Instrukcja to kompletne polecenie: "wypisz to", "dodaj te", "przypisz tamto". W Pythonie każda instrukcja trafia do osobnej linii:

greeting = "hello"
audience = "world"
print(greeting, audience)

Trzy instrukcje, trzy linie. Na końcu nie potrzebujesz średnika i większość kodu w Pythonie ich nie używa. (Możesz umieścić dwie instrukcje w jednej linii, rozdzielając je średnikiem, ale uchodzi to za zły styl. Nie rób tego.)

Jeśli linia naprawdę musi być długa, możesz ją złamać w naturalnym miejscu wewnątrz nawiasów okrągłych, kwadratowych albo klamrowych, a Python nie będzie narzekać:

totals = (
    1
    + 2
    + 3
    + 4
)
print(totals)

Albo, rzadziej, zakończyć linię ukośnikiem wstecznym, żeby ją kontynuować. Gdy się da, wybieraj sztuczkę z nawiasami: używa jej większość projektów.

Wcięcia tworzą strukturę

Tu potykają się nowicjusze. W Pythonie białe znaki na początku linii mają znaczenie. Mówią Pythonowi, które linie należą do siebie.

Spójrz na proste if:

hour = 9

if hour < 12:
    print("Good morning")
    print("The day is young")

print("This runs regardless")

Dwie linie po if hour < 12: mają wcięcie na cztery spacje. Python odczytuje to wcięcie jako "te dwie linie są ciałem if". Ostatnie print wraca do lewego marginesu, więc Python uznaje je za leżące poza if.

Jeśli usuniesz wcięcie, if przestanie działać. Jeśli dodasz jedną spację za dużo, if też przestanie działać. Python jest tu surowy, bo wcięcie jest strukturą: nie ma { ani end, które by je wspierały.

Wynika z tego kilka zasad:

1. Wybierz cztery spacje na poziom wcięcia i trzymaj się tego. To konwencja PEP 8 i domyślne ustawienie każdego edytora dla plików .py.
2. Nie mieszaj tabulatorów i spacji. Python 3 odrzuci plik, który używa obu. Nowoczesne edytory przy zapisie automatycznie zamieniają tabulatory na spacje; upewnij się, że twój jest tak ustawiony.
3. Błędy wcięć będą się zdarzać. Gdy się pojawią, komunikat błędu poda numer linii. Sprawdź, czy białe znaki na początku tej linii są takie same jak w sąsiednich liniach.

Dwukropek otwiera blok

Każda konstrukcja, która tworzy zagnieżdżony blok (if, else, for, while, def, class, with, try), kończy linię nagłówka dwukropkiem. Następne linie z wcięciem tworzą ciało bloku:

def greet(name):
    print("Hello,", name)
    print("Welcome back")

for n in [1, 2, 3]:
    print(n * n)

Zwróć uwagę na dwie rzeczy: dwukropek na końcu nagłówka i wcięcie na cztery spacje w liniach ciała. Jeśli zapomnisz dwukropka, Python zgłosi coś w rodzaju SyntaxError: expected ':'. Ten błąd jest jednoznaczny: dodaj brakujący znak i gotowe.

Wielkość liter

Python traktuje Name, name i NAME jako trzy zupełnie osobne rzeczy. Dotyczy to:

• Twoich własnych zmiennych i funkcji.
• Wbudowanych nazw, takich jak print, len, True, False, None.
• Nazw modułów i atrybutów.

Zwykle daje to o sobie znać tylko wtedy, gdy przypadkiem napiszesz coś wielką literą. True to logiczna wartość prawdy; true to niezdefiniowana zmienna, która zgłasza NameError. Print(...) to nie funkcja print, tylko literówka.

Jeśli błąd mówi "name 'X' is not defined", a masz pewność, że ta nazwa jest zdefiniowana, najpierw sprawdź wielkość liter. W dziewięciu przypadkach na dziesięć to ona jest winna.

Komentarze z #

Wszystko po # w linii to komentarz: Python całkowicie go ignoruje. Komentarze to notatki dla przyszłych czytelników (także dla ciebie w przyszłości):

# This is a full-line comment. Python skips it.
x = 10  # You can also put a short comment at the end of a line.
print(x)

Python nie ma składni komentarza wieloliniowego. Jeśli potrzebujesz kilku linii, użyj kilku linii z #. (Czasem zobaczysz napisy w potrójnym cudzysłowie używane jako pseudokomentarze. To osobna rzecz, zwana docstringiem, i omówimy ją przy funkcjach.)

Słowa zarezerwowane

Kilku słów nie wolno używać jako nazw zmiennych, bo używa ich sam Python: if, else, for, while, def, class, return, import, from, as, pass, break, continue, True, False, None, and, or, not, in, is, lambda, try, except, finally, raise, with, yield, global, nonlocal, async, await. Nie musisz uczyć się tej listy na pamięć. Jeśli spróbujesz użyć któregoś z nich, Python od razu zaprotestuje.

Wiesz wystarczająco dużo, żeby czytać dowolny plik Pythona

Każda zasada z tej strony dotyczy każdego pliku Pythona, zarówno dwulinijkowego skryptu, jak i projektu na sto tysięcy linii. Reszta języka jest zbudowana na tych pięciu pomysłach. Jeśli plik wygląda zagmatwanie, rozwiązaniem prawie zawsze jest zwrócenie uwagi najpierw na wcięcia. Wcięcia mówią ci, co robi kod, zanim jeszcze przeczytasz, co jest w liniach.

Dalej: komentarze nieco dokładniej, a do tego docstringi, czyli sposób, w jaki Python obsługuje dokumentację funkcji i modułów.