1. Giới thiệu
Cấu trúc “if name == ‘main’” thường thấy trong các chương trình Python là một tính năng quan trọng để xác định cách một script được thực thi. Bằng cách sử dụng cấu trúc này, cùng một đoạn mã có thể hành xử khác nhau tùy thuộc vào việc nó được “chạy trực tiếp” hay “được nhập khẩu từ một script khác”. Hiểu đúng tính năng này, bạn có thể cải thiện khả năng tái sử dụng và bảo trì mã, đồng thời hỗ trợ việc gỡ lỗi và kiểm thử hiệu quả hơn. Trong bài viết này, chúng tôi sẽ giải thích chi tiết vai trò, cách sử dụng và lợi ích của cấu trúc này, kèm theo các ví dụ mã cụ thể.
2. Hiểu cơ bản về name và main của Python
Biến đặc biệt name của Python là gì?
Khi một chương trình Python được thực thi, một số biến đặc biệt được tạo tự động. __name__ là một trong số đó và lưu trữ tên của tệp (module) đang được thực thi. Thông thường, biến __name__ cho biết module nào đã chạy chương trình.
Lưu ý: Sự khác nhau giữa module và script Module: Một tệp chứa mã Python được thiết kế để được nhập khẩu và sử dụng bởi các tệp khác.
Script: Một tệp Python dự định được thực thi như một chương trình, thường không được nhập khẩu bởi các tệp khác mà được chạy trực tiếp.
Ví dụ: Hành vi của name
Ví dụ, hãy tưởng tượng một tệp example.py có nội dung sau.
# example.py
print(__name__)
Nếu bạn chạy tệp này trực tiếp, giá trị của __name__ sẽ trở thành '__main__', và terminal sẽ hiển thị:
__main__
Ngược lại, khi tệp được nhập khẩu từ một tệp khác, giá trị của __name__ sẽ được đặt thành tên tệp 'example' thay vì __main__. Điều này cho thấy giá trị của __name__ thay đổi tùy theo cách script được chạy.
main là gì?
Trình thông dịch gán tên đặc biệt “__main__” cho tệp đang được thực thi. Điều này cho phép một chương trình Python xác nhận rằng một script đang được chạy trực tiếp bằng cách kiểm tra “__main__“. 
3. Ứng dụng thực tế của if name == ‘main’
Sử dụng cấu trúc “if name == ‘main’” cho phép bạn thực thi mã cụ thể chỉ khi một script Python được chạy trực tiếp. Cấu trúc này rất hữu ích để kiểm soát hành vi của mã một cách tốt hơn.
Cú pháp cơ bản
if __name__ == '__main__':
# Code that runs only when the script is executed directly
print("This script is being run directly.")
Ví dụ cụ thể
Dưới đây là mã sử dụng tệp calculate.py làm ví dụ. Tệp này chứa một hàm và một câu lệnh điều kiện.
# calculate.py
def add(a, b):
return a + b
if __name__ == '__main__':
result = add(3, 4)
print("Calculation result:", result)
Kết quả thực thi
Nếu bạn chạy tệp này trực tiếp, nó sẽ tạo ra đầu ra sau.
Calculation result: 7
Ngược lại, nếu module calculate này được nhập khẩu từ một tệp khác, đoạn mã dưới if __name__ == '__main__' sẽ không được thực thi. Dưới đây là ví dụ về cách nhập khẩu và sử dụng nó từ một tệp khác, main_script.py.
# main_script.py
import calculate
# When imported, the code under if __name__ == '__main__' in calculate.py is not executed
print(calculate.add(10, 5)) # 15 is printed
Như vậy, việc sử dụng cấu trúc “if name == ‘main’” cho phép bạn làm cho một script hành xử khác nhau khi được chạy trực tiếp so với khi được nhập khẩu bởi một script khác.
4. Lợi ích của việc sử dụng cấu trúc này
1. Cải thiện khả năng tái sử dụng module
Sử dụng 「if name == ‘main’」 giúp tăng khả năng tái sử dụng của một module. Nó ngăn chặn việc chạy các đoạn mã không cần thiết khi module được nhập khẩu và cho phép bạn kiểm soát chỉ các phần cần thiết mới được thực thi, từ đó nâng cao khả năng bảo trì mã.
2. Dễ dàng kiểm thử
Bằng cách đặt mã kiểm thử hoặc gỡ lỗi bên trong if __name__ == '__main__', bạn có thể dễ dàng chạy các kiểm thử trong quá trình phát triển. Vì mã kiểm thử sẽ không được thực thi khi module được nhập khẩu, bạn có thể gỡ lỗi một cách hiệu quả hơn.
Ví dụ mã kiểm thử
Hãy thêm một đoạn kiểm thử đơn giản vào calculate.py.
# calculate.py
def add(a, b):
return a + b
if __name__ == '__main__':
# Test code
print("3 + 4 =", add(3, 4))
print("10 + 5 =", add(10, 5))
Bằng cách này, khi chỉ chạy các kiểm thử đơn giản khi mô-đun được thực thi trực tiếp, các kiểm thử sẽ không chạy khi mô-đun được nhập khẩu bởi mã khác, và chỉ các hàm cần thiết sẽ được sử dụng. 
5. Các biện pháp phòng ngừa và Thực hành tốt nhất
Phòng ngừa
- Cải thiện độ rõ ràng của mã
if __name__ == '__main__'Đặt mã kiểm thử và thực thi dưới điểm này để tách biệt rõ ràng các trách nhiệm trong tệp. Đảm bảo các phần không nên chạy khi nhập khẩu được bao quanh bởi điều kiện để mã không cần thiết không chạy nhầm. - Cẩn thận với việc nhập vòng Nếu nhiều tệp nhập khẩu lẫn nhau trong mã sử dụng
if __name__ == '__main__', hãy chú ý tránh nhập vòng. Các phụ thuộc mô-đun phức tạp làm tăng nguy cơ nhập vòng, vì vậy cố gắng giữ phụ thuộc đơn giản.
Thực hành tốt nhất
- Đặt mã kiểm thử trong khối chính Bằng cách đặt mã kiểm thử bên trong
if __name__ == '__main__', bạn ngăn việc thực thi không cần thiết khi mô-đun được nhập khẩu bởi mã khác. Đảm bảo các kiểm thử chỉ chạy khi mô-đun được thực thi trực tiếp giúp tránh hành vi không mong muốn. - Nhóm các hàm liên quan lại với nhau Bằng cách nhóm các hàm liên quan trong
if __name__ == '__main__'và gọi chúng khi cần, mã của bạn sẽ ngắn gọn, dễ đọc hơn và dễ bảo trì hơn.
6. Tóm tắt
Cấu trúc “if name == ‘main‘” là một cách tiện lợi để xác định cách một script Python được thực thi. Sử dụng cấu trúc này, bạn có thể đảm bảo rằng mã chỉ chạy khi script được thực thi trực tiếp, cải thiện khả năng tái sử dụng mô-đun và làm cho việc kiểm thử dễ dàng hơn. Khi lập trình bằng Python, hãy sử dụng cấu trúc này một cách hiệu quả và tách biệt script và mô-đun một cách thích hợp để nâng cao khả năng bảo trì và tái sử dụng mã.
