Hello Python — triết lý, cài đặt, môi trường biệt lập

1. Python là gì? Lịch sử và triết lý

Python được tạo bởi Guido van Rossum tại CWI (Hà Lan) vào cuối năm 1989, phát hành bản công khai đầu tiên năm 1991. Cái tên không liên quan gì đến loài rắn — Guido lấy cảm hứng từ chương trình hài kịch Anh Monty Python's Flying Circus. Điều đó giải thích vì sao tài liệu Python chính thống hay có ví dụ spam, eggs, foo, bar.

Guido được cộng đồng gọi là BDFL (Benevolent Dictator For Life — "Lãnh đạo độc tài nhân từ trọn đời") — vị trí ông giữ cho đến khi từ chức năm 2018. Sau đó Python được điều hành bởi Steering Council (Hội đồng điều hành) gồm 5 thành viên bầu lại hàng năm.

1.1. Ai dùng Python?

Python là ngôn ngữ đa dụng. Vài lĩnh vực nó áp đảo:

• Data Science / ML / AI — pandas, NumPy, PyTorch, TensorFlow, scikit-learn. OpenAI, Anthropic, Google DeepMind đều dùng Python làm ngôn ngữ chính cho research.
• Web backend — Django (Instagram, Disqus), FastAPI (modern, async). Instagram chạy backend lớn nhất thế giới trên Django.
• Scripting / Automation — viết script cho DevOps, sysadmin. Ansible viết bằng Python.
• Khoa học — NASA dùng Python cho phân tích dữ liệu vệ tinh, mô phỏng quỹ đạo. CERN dùng Python phân tích dữ liệu Large Hadron Collider.
• Tài chính — Jane Street, Bloomberg, các quant fund.
• Giáo dục — ngôn ngữ #1 dạy lập trình ở đại học (thay thế Java, C++).

1.2. The Zen of Python (PEP 20)

Triết lý Python được tóm tắt trong PEP 20 — The Zen of Python bởi Tim Peters. Đây là 19 nguyên tắc thiết kế được "in" mỗi khi gõ import this trong REPL — một easter egg nổi tiếng.

Đối lập với "JavaScript có 10 cách viết một thứ", Python theo nguyên tắc "chỉ một cách hiển nhiên để làm". Đó là lý do code Python của người này đọc giống người khác — phong cách bị "ép" bởi triết lý ngôn ngữ.

2. Cài Python — đúng cách

Đây là bước nhiều người làm sai từ đầu, dẫn đến lỗi khó hiểu nhiều tháng sau. Hãy đi chậm.

2.1. macOS / Linux — pyenv (khuyên dùng)

pyenv là tool quản lý nhiều phiên bản Python song song. Tương tự nvm cho Node hoặc fnm. Lý do nên dùng:

• Một máy có thể cài nhiều Python (3.10, 3.11, 3.12, 3.13) cùng lúc.
• Mỗi project chọn version riêng qua file .python-version.
• Không cần sudo. Không đụng system Python.

# Cài qua Homebrew
brew install pyenv

# Thêm vào ~/.zshrc (shell zsh mặc định của macOS)
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
echo '[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(pyenv init -)"' >> ~/.zshrc

# Restart terminal hoặc:
source ~/.zshrc

# Liệt kê tất cả version cài được
pyenv install --list | grep "^  3\." | tail -20

# Cài Python 3.12 (latest patch)
pyenv install 3.12

# Đặt làm default cho toàn user
pyenv global 3.12

# Verify
python --version    # Python 3.12.x
which python        # ~/.pyenv/shims/python (KHÔNG phải /usr/bin/python)

Linux (Ubuntu/Debian) cài pyenv qua script chính thức:

curl https://pyenv.run | bash
# Thêm config vào ~/.bashrc (giống macOS, đổi .zshrc → .bashrc)

2.2. Windows — official installer hoặc pyenv-win

Windows không có "system Python" — bạn phải tự cài. 2 cách:

• Official installer từ python.org. Cài đặt tick ô "Add Python to PATH". Đơn giản cho người mới.
• pyenv-win (fork riêng cho Windows) nếu cần quản lý nhiều version. Cài qua PowerShell: Invoke-WebRequest ...
• WSL2 — nhiều dev Windows hôm nay chạy Linux trên WSL2 rồi cài pyenv như Linux. Trải nghiệm tốt hơn native Windows.

2.3. Cài qua uv — modern alternative (2024+)

uv (do Astral phát hành, cùng team với Ruff) cũng có chức năng cài Python phiên bản bất kỳ, nhanh hơn pyenv rất nhiều (uv viết bằng Rust). Sẽ trở lại uv ở section 7 — nhưng nếu bạn chưa dùng pyenv, có thể bắt đầu thẳng với uv.

# Cài uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# uv tự cài Python cho bạn
uv python install 3.12

# Liệt kê Python đã cài
uv python list

3. REPL — sân chơi đầu tiên

REPL (Read-Eval-Print Loop) là chế độ tương tác. Gõ một biểu thức, nhấn Enter, Python trả về kết quả ngay. Cách nhanh nhất để thí nghiệm syntax mà không cần tạo file.

$ python
Python 3.12.1 (main, Dec  7 2023, 21:50:54) [Clang 15.0.0] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> 1 + 1
2
>>> name = "Việt"
>>> print(f"Xin chào {name}")
Xin chào Việt
>>> import sys
>>> sys.version_info
sys.version_info(major=3, minor=12, micro=1, releaselevel='final', serial=0)
>>> exit()

Thoát REPL: gõ exit() hoặc nhấn Ctrl + D (macOS/Linux), Ctrl + Z rồi Enter (Windows).

4. Hello World — file .py đầu tiên

Tạo file hello.py:

print('Xin chào Python')

Chạy:

$ python hello.py
Xin chào Python

Đọc command-line argument qua sys.argv:

import sys

# sys.argv[0] = đường dẫn file .py
# sys.argv[1:] = các args user truyền
name: str = sys.argv[1] if len(sys.argv) > 1 else 'bạn'
print(f'Xin chào, {name}')

$ python greet.py
Xin chào, bạn

$ python greet.py Việt
Xin chào, Việt

4.1. Chú thích — # và docstring

Python có hai cơ chế ghi chú khác hẳn nhau về bản chất. # là chú thích thật sự — interpreter bỏ qua hoàn toàn, không tồn tại lúc chạy. Docstring là một chuỗi ký tự đặt ở vị trí đặc biệt — nó là dữ liệu thật, được lưu vào __doc__ và đọc được lúc chạy.

# Chú thích một dòng — mọi thứ sau dấu # đều bị bỏ qua

x = 42  # chú thích cuối dòng: cách code ÍT NHẤT 2 dấu cách (PEP 8)

# Python KHÔNG có cú pháp chú thích nhiều dòng như /* ... */ của JS.
# Muốn nhiều dòng thì đặt # ở mỗi dòng.
# Trong editor: bôi đen rồi Cmd+/ (macOS) hoặc Ctrl+/ (Windows/Linux).

"""
Chuỗi ba nháy KHÔNG phải chú thích — nó là một chuỗi thật sự,
chỉ là không được gán cho biến nào nên bị bỏ đi ngay.
Dùng nó làm "chú thích" thì code vẫn chạy, nhưng đây là cách dùng sai.
"""

"""Module docstring — dòng ĐẦU TIÊN của file, mô tả cả module."""

def tinh_bmi(can_nang: float, chieu_cao: float) -> float:
    """Tính chỉ số khối cơ thể (BMI).

    Args:
        can_nang: Cân nặng tính bằng kilogram.
        chieu_cao: Chiều cao tính bằng mét.

    Returns:
        Chỉ số BMI = cân nặng / chiều cao².

    Raises:
        ValueError: Nếu chiều cao nhỏ hơn hoặc bằng 0.
    """
    if chieu_cao <= 0:
        raise ValueError("chiều cao phải lớn hơn 0")
    return can_nang / chieu_cao ** 2


# Docstring đọc được LÚC CHẠY — khác hẳn chú thích #
print(tinh_bmi.__doc__)      # in ra toàn bộ docstring
help(tinh_bmi)              # hiển thị đẹp trong REPL

# ❌ Vô dụng — code đã nói y hệt rồi
i = i + 1   # tăng i lên 1

# ✅ Có giá trị — giải thích lý do mà code không nói được
time.sleep(0.3)   # API bên đối tác giới hạn 3 request/giây

# ✅ Cảnh báo cho người sau
# KHÔNG đổi sang set: thứ tự ở đây quyết định thứ tự hiển thị cho user.
danh_muc = ["moi", "pho_bien", "gia_re"]

# ✅ Đánh dấu việc còn nợ — IDE và linter nhận diện được TODO/FIXME
# TODO(anh): thay bằng cache Redis khi lượng truy cập vượt 1000/phút

5. Virtual environment — vì sao cần?

Đây là khái niệm sống còn của Python ecosystem. Hiểu nó trước khi cài bất kỳ package nào.

Default, khi bạn gõ pip install requests, package requests được cài vào Python interpreter hiện tại. Tức là tất cả project Python trên máy bạn đều thấy requests phiên bản đó.

Bài toán nảy sinh:

Virtual environment (venv) là thư mục biệt lập chứa một bản Python interpreter riêng + một thư mục site-packages riêng. Mỗi project có venv riêng → package không conflict.

6. Tạo venv với python -m venv

Python 3.3+ có module venv built-in. Lệnh tạo:

# Tạo project mới
mkdir my-app && cd my-app

# Tạo venv tên .venv (convention)
python -m venv .venv

# Activate (macOS/Linux)
source .venv/bin/activate

# Activate (Windows PowerShell)
.venv\Scripts\Activate.ps1

# Sau khi activate, prompt sẽ có (.venv) ở đầu:
# (.venv) $ which python
# /Users/you/my-app/.venv/bin/python  (KHÔNG còn là pyenv shim)

# Cài package — chỉ vào venv này
pip install requests

# Deactivate khi xong
deactivate

Cấu trúc venv tạo ra:

.venv/
├── bin/                    # Windows: Scripts/
│   ├── activate            # shell script set PATH + prompt
│   ├── python              # symlink hoặc copy interpreter
│   ├── pip
│   └── ...
├── lib/
│   └── python3.12/
│       └── site-packages/  # package cài vào venv này nằm ở đây
└── pyvenv.cfg              # config trỏ tới base Python

.venv/
__pycache__/
*.pyc
.python-version

6.1. File .python-version — auto-switch

Nếu bạn dùng pyenv, có thể tạo file .python-version ở gốc project. pyenv tự switch Python khi bạn cd vào.

# Tại gốc project
pyenv local 3.12       # tạo .python-version chứa "3.12"

# Verify
cat .python-version    # 3.12.x
python --version       # auto pick 3.12 khi ở folder này

7. uv — tool modern (2024+)

uv là tool quản lý Python + package thế hệ mới, do Astral (team Ruff) phát triển, viết bằng Rust. Mục tiêu: thay thế tất cả các tool cũ (pyenv, virtualenv, pip, pip-tools, poetry, pipx) bằng một binary duy nhất, nhanh hơn 10-100 lần.

7.1. uv init — khởi tạo project mới

# Tạo project mới
uv init my-app
cd my-app

# Cấu trúc sinh ra:
#   my-app/
#   ├── .python-version
#   ├── README.md
#   ├── hello.py
#   └── pyproject.toml

# Thêm dependency
uv add requests

# uv tự: tạo .venv/, resolve dep, cài, ghi vào pyproject.toml + uv.lock

# Chạy file (uv tự activate venv ngầm)
uv run hello.py

# Thêm dev-only dep
uv add --dev ruff pytest

7.2. pyenv hay uv — chọn cái nào?

Hai tool không loại trừ nhau, nhưng phạm vi khác hẳn: pyenv chỉ quản lý phiên bản Python, còn uv quản lý cả Python lẫn venv, package, lock file. Dùng pyenv thì vẫn cần thêm pip + venv (hoặc poetry); dùng uv thì một binary là đủ.

7.3. Chuyển từ pyenv sang uv

❯ which python
python: aliased to python3

Quy trình chuyển hẳn sang uv trên macOS:

# 1. Cài uv (nếu chưa có) — chọn MỘT cách
curl -LsSf https://astral.sh/uv/install.sh | sh    # cài vào ~/.local/bin
brew install uv                                    # hoặc qua Homebrew

# 2. Cài bản Python bạn cần và đặt làm python mặc định
uv python install 3.12 --default    # tạo python, python3 trong ~/.local/bin

# 3. Xóa cấu hình pyenv trong ~/.zshrc — 3 dòng này:
#   export PYENV_ROOT="$HOME/.pyenv"
#   [[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"
#   eval "$(pyenv init -)"

# 4. Gỡ pyenv và các bản Python nó đã cài
brew uninstall pyenv
rm -rf ~/.pyenv                     # xóa luôn mọi Python + package cài qua pyenv

# 5. Mở terminal mới và kiểm tra
type -a python      # ~/.local/bin/python đứng đầu
python --version    # Python 3.12.x

8. pip cơ bản và PyPI

pip là package installer mặc định của Python (đi kèm Python từ 3.4). PyPI (pypi.org — Python Package Index) là registry chính thức, có hơn 500,000+ package.

# Cài package vào venv hiện tại
pip install requests
pip install "requests>=2.31,<3"     # pin range version

# Cài nhiều package từ file
pip install -r requirements.txt

# Liệt kê package đã cài
pip list
pip show requests                # info chi tiết một package

# Sinh requirements.txt từ venv hiện tại
pip freeze > requirements.txt

# Gỡ package
pip uninstall requests

# Upgrade pip itself
python -m pip install --upgrade pip

File requirements.txt mẫu:

requests>=2.31,<3
httpx==0.27.0
pydantic>=2.0
# dev tools (tách file requirements-dev.txt sẽ đẹp hơn)
pytest>=8.0
ruff>=0.4

9. pyproject.toml — manifest hiện đại

pyproject.toml là format manifest chuẩn của Python, định nghĩa trong PEP 518 (2016) và PEP 621 (2020). Tương đương package.json của Node, pubspec.yaml của Dart.

Mẫu cơ bản (uv init sinh sẵn):

[project]
name = "my-app"
version = "0.1.0"
description = "Dự án Python đầu tiên"
readme = "README.md"
requires-python = ">=3.12"
dependencies = [
    "requests>=2.31",
    "pydantic>=2.0",
]

[project.optional-dependencies]
dev = [
    "pytest>=8.0",
    "ruff>=0.4",
]

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

10. PEP 8 và Zen of Python — kim chỉ nam

PEP = Python Enhancement Proposal. Là tài liệu chính thức đề xuất tính năng / quy chuẩn cho ngôn ngữ. Hai PEP quan trọng nhất cho người mới:

• PEP 8 — Style Guide for Python Code. Định nghĩa quy ước: 4 space indent (không tab), snake_case cho biến/function, PascalCase cho class, dòng ≤ 79 (hoặc 88-100) ký tự, 2 dòng trống giữa hàm top-level, v.v.
• PEP 20 — The Zen of Python. Đã trích ở section 1.3. Đọc bằng import this.

Thử ngay trong REPL:

>>> import this
The Zen of Python, by Tim Peters

Beautiful is better than ugly.
Explicit is better than implicit.
Simple is better than complex.
Complex is better than complicated.
Flat is better than nested.
Sparse is better than dense.
Readability counts.
Special cases aren't special enough to break the rules.
Although practicality beats purity.
Errors should never pass silently.
Unless explicitly silenced.
In the face of ambiguity, refuse the temptation to guess.
There should be one-- and preferably only one --obvious way to do it.
Although that way may not be obvious at first unless you're Dutch.
Now is better than never.
Although never is often better than *right* now.
If the implementation is hard to explain, it's a bad idea.
If the implementation is right to explain, it may be a good idea.
Namespaces are one honking great idea -- let's do more of them!

Bạn không cần thuộc lòng PEP 8 — dùng tool format tự động như ruff hoặc black để máy ép code theo chuẩn. Sub-pillar này dùng ruff (cũng của Astral, Rust, nhanh).

11. IDE setup — VS Code hoặc PyCharm

2 lựa chọn chính:

12. Python có "compile" không?

Câu trả lời ngắn: Có, nhưng không phải kiểu bạn đang nghĩ.

Python không compile sang executable (binary chạy độc lập) như C, Go, hoặc Dart AOT. Bạn không thể ./hello như C. Bạn phải gõ python hello.py — cần Python interpreter có mặt.

Tuy nhiên, ngầm trong runtime, Python có compile sang bytecode (.pyc) trung gian, được Python Virtual Machine (PVM) thực thi. Bytecode được cache trong thư mục __pycache__/:

# Sau khi import một module Python lần đầu
$ python -c "import mymodule"

# __pycache__ xuất hiện cạnh file .py
$ ls __pycache__/
mymodule.cpython-312.pyc

# Đây là bytecode cache cho Python 3.12
# Lần import sau Python skip parse + compile lại, dùng cache

__pycache__/ — có commit không?

Không. Bytecode tự sinh, phụ thuộc Python version (3.11 .pyc khác 3.12 .pyc). Thêm vào .gitignore:

__pycache__/
*.pyc
*.pyo
.venv/
.python-version
.ruff_cache/
.mypy_cache/

13. Cheat sheet chương 1

Bài tập

# Setup
mkdir fetch-demo && cd fetch-demo
python -m venv .venv
source .venv/bin/activate
pip install requests

# fetch.py
import requests

response = requests.get("https://httpbin.org/get")
print(response.json())

# greet.py
import sys

name: str = sys.argv[1] if len(sys.argv) > 1 else "bạn"
print(f"Xin chào, {name}")

Quiz

Tổng kết

Sau chương 1, bạn nên đã nắm:

• Python landscape: ngôn ngữ 35 tuổi, BDFL → Steering Council, thống trị data/AI/scripting.
• Cài đúng cách: KHÔNG dùng system Python; dùng pyenv hoặc uv.
• REPL: sân chơi nhanh nhất để thí nghiệm syntax; biết IPython như upgrade.
• Virtual environment: cô lập package từng project — không phải tùy chọn, mà là bắt buộc.
• pip vs uv: pip mặc định, uv hiện đại nhanh hơn. pyproject.toml là manifest chuẩn.
• Zen of Python: 19 nguyên tắc dẫn dắt cách viết code. Đọc, hiểu, ngấm dần.
• Compile mode: bytecode trong __pycache__, không tạo executable AOT.

Kết nối tới các chương khác

Mọi chương sau giả định bạn đã có Python 3.12+ chạy được và biết venv. Cụ thể:

• Chương 2 (Variables, Types & Operators) — bắt đầu syntax thực sự: biến, kiểu, toán tử. Type hint sẽ được dùng từ ví dụ đầu tiên.
• Chương 4 (Functions) — đào sâu sys.argv, *args, **kwargs.
• Chương 12 (Typing & Static Analysis) — toàn bộ hệ thống type hint, Pylance strict mode, Protocol, Generic.
• Trụ cột CLI — pyenv, venv là cấp độ tool CLI. Nếu chưa quen terminal/shell, đọc trụ cột CLI trước.
• Trụ cột DevOps — Python application thường được package qua Docker (multistage build với python:3.12-slim). Chương DevOps có example với Python.