Bạn tải về một đoạn code Python mà đồng nghiệp gửi, gõ python tenfile.py và màn hình báo "không tìm thấy lệnh". Hoặc tệ hơn, trên Windows nó mở hẳn cửa hàng Microsoft Store. Mình gặp cảnh này nhiều lần, ở máy của chính mình lẫn máy của khách. Hầu như lần nào cũng là chuyện cài đặt, không phải chuyện bạn học chưa giỏi.
Bài này đi từ máy trống đến lúc chạy được chương trình đầu tiên, và chỉ dùng cách đang được tài liệu chính thức khuyên dùng.
Python bây giờ là bản nào
Mình kiểm trên trang python.org ngày 21/10/2026: bản ổn định mới nhất là Python 3.15.0, phát hành ngày 9/10/2026. Các bản 3.14, 3.13, 3.12 và 3.11 vẫn còn được hỗ trợ. Bản 3.10 đã hết hạn hỗ trợ từ đầu tháng 10/2026, nên nếu máy bạn còn 3.10 hay cũ hơn thì nên lên bản mới.
Bạn không cần phải chạy theo bản mới nhất ngay trong tuần đầu. Một thư viện bạn định dùng có thể chưa kịp cập nhật cho bản vừa ra. Nếu gặp tình huống đó, bản 3.14 hoặc 3.13 là chỗ dựa an toàn. Với người mới, chọn bản mới nhất thường ổn, và phần "uv" bên dưới giúp bạn đổi bản rất dễ.
Cài Python lên máy
Trên Windows, tài liệu Python 3.15 khuyên dùng một công cụ tên là Python install manager, tải ở python.org/downloads hoặc từ Microsoft Store. Cài xong, các lệnh python, py và pymanager sẽ chạy được trong cửa sổ dòng lệnh. Trình cài đặt kiểu cũ (file .exe) đã bị đánh dấu lỗi thời từ 3.14 và sẽ không còn từ 3.16.
Trên macOS, tải file .pkg ở python.org/downloads/macos, bấm tiếp tục theo màn hình. Cài xong, mở thư mục /Applications/Python 3.15/ và bấm đúp file Install Certificates.command. Bước này hay bị bỏ qua, và bỏ qua là sau này lỗi chứng chỉ SSL (mình kể ở phần lỗi). Trên Mac, lệnh là python3, không phải python.
Trên Linux, hầu hết bản phân phối đã có sẵn python3. Gõ python3 --version để xem.
Kiểm tra xong, bạn sẽ thấy dòng kiểu Python 3.15.0. Mình khuyên đừng xoá hay sửa bản Python có sẵn của macOS (/usr/bin/python3). Hệ điều hành và phần mềm khác đang dùng nó.
Mỗi dự án một "phòng riêng"
Đây là chỗ nhiều người mới vấp. Bạn cài một thư viện (đoạn code viết sẵn của người khác, ví dụ thư viện đọc Excel) vào máy. Vài tháng sau, dự án khác cần bản cũ hơn của chính thư viện đó. Hai dự án giẫm lên nhau.
Cách giải quyết là cho mỗi dự án một môi trường riêng (tên kỹ thuật là virtual environment): một thư mục chứa đúng Python và đúng thư viện của dự án đó, không dính gì tới dự án khác. Hình dung như mỗi dự án có một phòng riêng với bộ đồ nghề riêng.
Trên Ubuntu mình gặp luôn phiên bản dễ thấy của chuyện này. Gõ pip3 install requests vào Python của hệ thống, máy trả lời error: externally-managed-environment. Nó không cho bạn cài thẳng vào Python của hệ điều hành, và đó là chủ ý.
Dùng uv để làm mọi thứ trên
Có nhiều cách tạo môi trường riêng. Mình dùng uv, một công cụ do Astral làm, vì một lệnh lo được cả việc tải đúng bản Python, tạo môi trường và cài thư viện. Mình đã cài và chạy thử ở bản uv 0.13.4.
Cài uv (theo docs.astral.sh/uv):
# macOS và Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Cài xong, đóng cửa sổ dòng lệnh và mở lại để máy nhận lệnh uv. Sau này muốn cập nhật thì gõ uv self update.
Chạy chương trình đầu tiên, từng bước
Bước 1, tạo thư mục dự án và khởi tạo:
mkdir baitap && cd baitap
uv init --bare --python 3.15
Lệnh này tạo một file pyproject.toml, là tờ khai ghi dự án cần Python bản nào và thư viện nào. Nếu máy chưa có Python 3.15, uv tự tải về cho bạn khi cần. Mình chạy thử trên máy chưa cài 3.15 và nó tải xong trong vài giây.
Bước 2, thêm một thư viện (ví dụ requests, thư viện gọi trang web):
uv add requests
Lệnh này cài thư viện vào môi trường riêng của dự án (thư mục .venv) và ghi lại đúng phiên bản vào file uv.lock. Hôm mình thử, nó cài requests 2.34.2 mất khoảng một giây.
Bước 3, tạo file chao.py bằng trình soạn thảo bất kỳ:
import sys
import requests
ten = sys.argv[1] if len(sys.argv) > 1 else "bạn"
r = requests.get("https://httpbin.org/get", timeout=10)
print(f"Xin chào {ten}! Python {sys.version.split()[0]}, requests {requests.__version__}")
print("Trang trả lời mã", r.status_code)
Bước 4, chạy:
uv run chao.py Lan
Kết quả mình nhận được trên máy thử:
Xin chào Lan! Python 3.15.0, requests 2.34.2
Trang trả lời mã 200
Bạn không cần "kích hoạt" môi trường gì cả. uv run tự dùng đúng môi trường của dự án. Nếu muốn kích hoạt tay vẫn được: source .venv/bin/activate trên Mac và Linux, .venv\Scripts\activate trên Windows.
Khi gửi dự án cho người khác, bạn gửi kèm pyproject.toml và uv.lock. Họ gõ uv sync là có môi trường giống hệt của bạn.
Lỗi hay gặp trên Windows và macOS
Gõ python trên Windows lại mở Microsoft Store. Đây là chuyện Windows có sẵn một lối tắt giả cho lệnh python. Tài liệu Python chỉ cách sửa: mở Start, tìm "Manage app execution aliases", kiểm tra các mục "Python (default)" đang bật; nếu đã bật thì thử tắt rồi bật lại. Đồng thời kiểm biến PATH có chứa thư mục %UserProfile%\AppData\Local\Microsoft\WindowsApps.
Lệnh py báo "can't open file". Thường là máy còn bộ khởi chạy py đời cũ cài từ trước và nó chiếm quyền. Gỡ mục "Python launcher" trong phần Installed apps rồi thử lại.
Cài uv xong gõ uv vẫn báo không tìm thấy. Gần như luôn là do cửa sổ dòng lệnh cũ chưa biết đường dẫn mới. Đóng hẳn, mở lại.
macOS báo command not found: python. Trên Mac bạn dùng python3. Muốn gõ ngắn thì để uv run lo, vì nó tự chọn đúng Python.
macOS báo CERTIFICATE_VERIFY_FAILED khi gọi một trang web. Đây là hệ quả của việc quên bấm file Install Certificates.command lúc cài Python từ python.org. Mở thư mục /Applications/Python 3.15/ và chạy file đó. Nếu bạn dùng Python do uv tải về thì thường không dính chuyện này, nhưng mình chưa thử trên máy Mac nên chỗ này mình nói theo tài liệu.
Linux báo externally-managed-environment. Đừng ép bằng cờ phá khoá. Tạo môi trường riêng như trên là xong.
Việc nên làm tiếp
Chạy được một file in ra màn hình mới là bước đầu. Hai hướng mình thấy hợp cho người đang đi làm là biến Python thành trợ lý cho công việc hằng ngày, như trong bài Tự động hoá việc văn phòng bằng Python: gộp Excel, làm báo cáo và gửi mail, hoặc viết một cổng dữ liệu nhỏ cho ứng dụng như bài Viết API đầu tiên với FastAPI: quản lý sản phẩm, kiểm dữ liệu và tài liệu tự sinh.
Nếu bạn cần ai đó dựng môi trường và viết công cụ Python cho cửa hàng hay văn phòng của mình, cứ nhắn mình qua trang liên hệ.
