Những cạm bẫy khi phân tích phiên bản Python 3.10: Tại sao 3.10 có thể bị hiểu nhầm là "3.1"

[Python 3.10 Issues] Version Number Parsing Pitfalls

Triệu chứng

Các script phát hiện môi trường nhầm lẫn Python 3.10 với Python 3.1.
Logic điều kiện sử dụng so sánh chuỗi tạo ra kết quả sai:

if platform.python_version() < "3.9":

    ...

có thể hoạt động không chính xác dưới phiên bản 3.10.

Nguyên nhân

Một số công cụ và script đã so sánh chuỗi phiên bản một cách ngây thơ thay vì phân tích cú pháp chúng dưới dạng tuple các số nguyên. So sánh chuỗi là từ điển — "3.10" đứng trước "3.9" vì "1" nhỏ hơn "9" ở vị trí ký tự thứ hai.

Vấn đề này ảnh hưởng đến các trình cài đặt pip cũ hơn, cấu hình tox và các script triển khai nội bộ không tính đến các phiên bản phụ có hai chữ số. Nó cũng được đề cập trong hướng dẫn chuyển đổi sang Python 3.10.

Khắc phục / Các thực tiễn tốt nhất

1) Sử dụng sys.version_info để so sánh

import sys



if sys.version_info < (3, 9):

    print("Python < 3.9 detected")

sys.version_info trả về một cấu trúc kiểu tuple: (major, minor, micro, releaselevel, serial) — an toàn cho việc so sánh số học.

2) Đối với việc đóng gói, hãy sử dụng packaging.version

from packaging import version

import platform



if version.parse(platform.python_version()) < version.parse("3.9"):

    ...

3) Cập nhật công cụ

Nâng cấp pip, setuptools, tox và trình chạy CI — các phiên bản mới hơn xử lý 3.10+ một cách chính xác.
Kiểm tra các script shell và tệp cấu hình để tìm các so sánh chuỗi thô như:

if [ "$(python3 --version)" \< "Python 3.9" ]; then ...

Cách tránh điều này trong tương lai

Luôn phân tích cú pháp phiên bản theo số học, không phải từ điển.
Kiểm thử các kiểm tra phiên bản của bạn với các bản phát hành ứng cử viên sắp tới (ví dụ: 3.13.0rc1).
Theo dõi lịch phát hành Hướng dẫn dành cho nhà phát triển Python để dự đoán các phiên bản phụ có hai chữ số.