---
title: "Bắt đầu với Python năm 2026: cài đặt, môi trường riêng và chạy chương trình đầu tiên"
url: https://phatdev.net/vi/blog/python-start-2026
lang: vi
updated: 2026-10-21
alternate:
  en: https://phatdev.net/en/blog/python-start-2026
markdown: https://phatdev.net/vi/blog/python-start-2026.md
---

# Bắt đầu với Python năm 2026: cài đặt, môi trường riêng và chạy chương trình đầu tiên

> Gõ python mà máy mở Microsoft Store? Cách cài Python 3.15, dùng uv để mỗi dự án có môi trường riêng, chạy chương trình đầu tiên và sửa các lỗi hay gặp trên Windows, macOS.

Chuyên mục: Backend | Đăng: 2026-10-21 | Cấp độ: Cơ bản | 7 phút đọc

Tags: python, uv, beginner, windows, macos, setup

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.

![Ba dự án, mỗi dự án một môi trường riêng](https://phatdev.net/uploads/blog/python-start-2026/env-1920.webp)

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):

```bash
# macOS và Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
```

```powershell
# 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ốn bước từ máy trống đến chạy được chương trình](https://phatdev.net/uploads/blog/python-start-2026/steps-1920.webp)

Bước 1, tạo thư mục dự án và khởi tạo:

```bash
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):

```bash
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ỳ:

```python
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:

```bash
uv run chao.py Lan
```

Kết quả mình nhận được trên máy thử:

```text
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

![Con đường rẽ đôi: một nhánh bị chắn bởi cảnh báo, nhánh kia thông qua cổng sáng](https://phatdev.net/uploads/blog/python-start-2026/trouble-1920.webp)

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](https://phatdev.net/vi/blog/python-office-automation), 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](https://phatdev.net/vi/blog/python-fastapi-first-api).

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ệ.

## Nguồn tham khảo

- [Python Downloads (python.org)](https://www.python.org/downloads/)
- [Using Python on Windows (Python 3.15 docs)](https://docs.python.org/3/using/windows.html)
- [Using Python on macOS (Python 3.15 docs)](https://docs.python.org/3/using/mac.html)
- [uv installation (Astral)](https://docs.astral.sh/uv/getting-started/installation/)
- [Working on projects with uv (Astral)](https://docs.astral.sh/uv/guides/projects/)
- [Python versions in uv (Astral)](https://docs.astral.sh/uv/concepts/python-versions/)

## Bài liên quan

- [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](https://phatdev.net/vi/blog/python-office-automation.md)
- [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](https://phatdev.net/vi/blog/python-fastapi-first-api.md)
- [Gom nhiều quyền vào một con số: bitmask cho quyền người dùng và địa chỉ IP](https://phatdev.net/vi/blog/bitwise-in-practice.md)