Hiểu và sửa lỗi cú pháp Python thường gặp

Mỗi ngôn ngữ lập trình đều có một tập hợp quy tắc hoặc ngữ pháp mà nó tuân theo. Vi phạm các quy tắc này dẫn đến cái gọi là lỗi cú pháp Python, có thể khiến mã của bạn thất bại. Những vấn đề này xảy ra với tất cả mọi người—dù bạn mới bắt đầu hay đã lập trình nhiều năm. Nếu bạn từng tự hỏi, “lỗi cú pháp trong Python là gì?”, thì bài viết này đề cập đến những lỗi phổ biến nhất và giải thích cách khắc phục chúng khi bạn lập trình.

Các lỗi Python thường gặp và cách khắc phục

Khi một lỗi cú pháp trong Python xảy ra, nó sẽ cung cấp một thông báo chỉ ra vấn đề. Thông báo này thường bao gồm:

• Tên tệp và số dòng nơi xảy ra vấn đề.
• Dòng mã cụ thể gây ra lỗi.
• Ký hiệu mũ (^) chỉ chính xác vị trí mà trình thông dịch bị nhầm lẫn.
• Mô tả về lỗi gợi ý bản chất của vấn đề.

Hãy cùng xem xét các lỗi cú pháp phổ biến trong Python mà lập trình viên thường gặp phải.

Thiếu hoặc không khớp dấu ngoặc

Một trong những lỗi phổ biến nhất mà người mới hay mắc phải là quên đóng dấu ngoặc. Điều này đặc biệt thường xảy ra trong các lệnh gọi hàm và cấu trúc lồng nhau.

Ví dụ:

print("Hello, World!"

Thông báo lỗi:

Cách khắc phục:

Đảm bảo tất cả dấu ngoặc được đóng chính xác.

print("Hello, World!")

Lỗi thụt dòng trong Python

Thụt dòng chỉ định các khối mã. Lỗi cú pháp Python có thể xảy ra nếu có vấn đề với việc thụt dòng.

Ví dụ:

def greet():
print("Hello, World!")

Thông báo lỗi:

Cách khắc phục:

Thụt dòng khối mã đúng cách.

def greet():
    print("Hello, World!")

Lỗi dấu câu trong danh sách hoặc từ điển

Quên thêm dấu phẩy giữa các phần tử trong danh sách hoặc từ điển là một lỗi phổ biến khác.

Ví dụ:

fruits = {"type": "sweert" "name": "orange"}

Thông báo lỗi:

Cách khắc phục:

Thêm dấu phẩy bị thiếu giữa "sweert" và "name".

fruits = {"type": "sweert", "name": "orange"}

Từ khóa dự trữ của Python dùng sai

Sử dụng không đúng các từ khóa này cũng có thể dẫn đến lỗi cú pháp. Từ khóa là những từ dành riêng có ý nghĩa đặc biệt.

Ví dụ:

class = "Beginner"

Thông báo lỗi:

Cách khắc phục:

Chọn một tên khác không phải là từ khóa dự trữ.

level = "Beginner"

Tên biến không hợp lệ

Tên biến phải tuân thủ các quy tắc cụ thể. Việc sử dụng tên biến không hợp lệ, chẳng hạn như bắt đầu bằng số hoặc chứa khoảng trắng, sẽ gây ra lỗi cú pháp trong Python.

Ví dụ:

2name = "John"

Thông báo lỗi:

Cách khắc phục:

Sử dụng một tên biến hợp lệ.

name2 = "John"

Chuỗi chưa đóng

Chuỗi phải được đặt trong dấu ngoặc kép phù hợp. Quên đóng chuỗi dẫn đến lỗi cú pháp.

Ví dụ:

message = "Hello, World!

Thông báo lỗi:

Cách khắc phục:

Đảm bảo chuỗi được đóng bằng cùng loại dấu ngoặc kép.

message = "Hello, World!"

Thiếu dấu hai chấm trong câu lệnh phức hợp

Một lỗi cú pháp có thể xảy ra nếu thiếu dấu hai chấm (:) ở cuối một câu lệnh điều kiện phức hợp như if, for, while, hoặc def.

Ví dụ:

def greet()
    print("Hello, World!")

Thông báo lỗi:

Cách khắc phục:

Thêm dấu hai chấm ở cuối câu lệnh phức hợp.

def greet():
    print("Hello, World!")

Toán tử gán Python đặt sai chỗ

Sử dụng toán tử không đúng có thể gây ra lỗi cú pháp Python. Điều này bao gồm toán tử gán và toán tử so sánh.

Ví dụ:

if x = 10:
    print("x is 10")

Thông báo lỗi:

Cách khắc phục:

Sử dụng toán tử so sánh chính xác.

if x == 10:
    print("x is 10")

Mẹo để tránh những lỗi thường gặp khi sử dụng Python

1. Chỉnh sửa với Jupyter notebooks hoặc VS Code giúp làm nổi bật các dấu hiệu và vấn đề thường gặp khi bạn viết hoặc chỉnh sửa mã trong trình soạn thảo.
2. Viết và kiểm thử mã theo từng bước: điều này giúp bạn kiểm tra mã Python để phát hiện lỗi cú pháp sớm và sửa chúng trước khi chúng trở nên khó lần ra.
3. Thụt dòng nhất quán: duy trì việc sử dụng thống nhất khoảng trắng hoặc tab để thụt dòng nhằm tránh nhầm lẫn và sự cố.
4. Sử dụng công cụ linting: chạy pylint hoặc flake8 trên mã của bạn để kiểm tra các phần có thể gây vấn đề cũng như đảm bảo tuân thủ các tiêu chuẩn mã hóa.
5. Tham khảo tài liệu: luôn giữ tài liệu chính thức bên mình để hiểu rõ các quy tắc cú pháp và quy ước của ngôn ngữ.

Xử lý lỗi cú pháp trong thực tế

Hãy xem xét một đoạn script web scraping đơn giản có thể gặp lỗi và giúp hiểu cách sửa lỗi cú pháp bằng trình gỡ lỗi tích hợp sẵn của Python, pdb.

Gỡ lỗi một script web scraping với pdb

Mã gốc:

import requests
from bs4 import BeautifulSoup

url = "https://example.com"
response = requests.get(url)
soup = BeautifulSoup(response.content, 'html.parser')

titles = soup.find_all("h1")
for title in titles
    print(title.text)

Thông báo lỗi:

Cách khắc phục:

Thêm dấu hai chấm bị thiếu sau vòng lặp for.

import requests
from bs4 import BeautifulSoup

url = "https://example.com"
response = requests.get(url)
soup = BeautifulSoup(response.content, 'html.parser')

titles = soup.find_all("h1")
for title in titles:
    print(title.text)

Sử dụng pdb để gỡ lỗi:

Thêm dòng sau trước vòng lặp để khởi động trình gỡ lỗi.

import pdb; pdb.set_trace()

Thêm mã với điểm dừng break:

import requests
from bs4 import BeautifulSoup

url = "https://example.com"
response = requests.get(url)
soup = BeautifulSoup(response.content, 'html.parser')

titles = soup.find_all("h1")
import pdb; pdb.set_trace()
for title in titles:
    print(title.text)

Khi bạn chạy script, trình gỡ lỗi pdb sẽ bắt đầu tại điểm dừng.

> /path/to/your/script.py(10)()
-> for title in titles:
(Pdb)

Các lệnh gỡ lỗi:

• n (next): thực thi dòng mã tiếp theo.
• c (continue): tiếp tục thực thi cho đến khi gặp điểm dừng tiếp theo.
• p variable_name: in giá trị của biến.

Phiên làm việc mẫu:

(Pdb) n
> /path/to/your/script.py(11)()
-> print(title.text)
(Pdb) p titles
[<h1>Example Domain</h1>]
(Pdb) c
Example Domain

Với pdb, bạn có thể liên tục bước qua chương trình, quan sát giá trị của các biến khác nhau và hiểu cách mã được thực thi, cho phép phát hiện và sửa lỗi nhanh chóng.

Tránh lỗi runtime trong Python

Sử dụng pdb, bạn có thể bước qua chương trình, kiểm tra giá trị của các biến quan trọng và theo dõi luồng điều khiển để tìm ra lỗi và sai sót logic. Các vấn đề như chia cho 0, truy cập phần tử ngoài phạm vi trong danh sách, hoặc sử dụng biến chưa được định nghĩa là những lỗi phổ biến mà bạn có thể phát hiện theo cách này.

Ví dụ:

numbers = [1, 2, 3]
print(numbers[3])

Thông báo lỗi:

Cách khắc phục:

Đảm bảo bạn đang truy cập vào chỉ số hợp lệ trong danh sách.

print(numbers[2])

Xử lý ngoại lệ

Các khối try-except cho phép bạn bao bọc mã có thể gây ra vấn đề. Bằng cách bắt các vấn đề này, chương trình của bạn có thể tiếp tục chạy trơn tru ngay cả khi gặp lỗi cú pháp trong mã.

Ví dụ:

try:
    result = 10 / 0
except ZeroDivisionError:
    print("You can't divide by zero!")

Suy nghĩ cuối cùng

Làm quen với các lỗi phổ biến và xem lại các ví dụ về lỗi cú pháp trong Python là điều mà mọi lập trình viên nên làm. Càng chú ý nhiều đến các thông báo chẩn đoán — và càng sửa chúng nhanh chóng — thì mã của bạn sẽ chạy càng trơn tru. Hãy sử dụng các công cụ và mẹo thực sự hỗ trợ công việc của bạn.