•4 phút đọc
Cài Đặt Môi Trường Phát Triển Python Hiện Đại với pyenv, Poetry, uv, và pyproject.toml
Thiết Lập Môi Trường Python Hiện Đại
Việc chỉ dùng pip install ngày nay rất dễ gây ra lỗi xung đột phiên bản hay lỗi "code chạy trên máy tôi nhưng server thì chết".
Để phát triển Python chuyên nghiệp, bạn cần cách ly môi trường, khóa phiên bản (lock dependencies), và quản lý bản build.
Audio Briefing• Voice: Google Cloud vi-VN-Neural2-A
0:00 / --:--
Các Công Cụ Tiêu Chuẩn Hiện Nay
- pyenv: Quản lý và chuyển đổi qua lại giữa các phiên bản Python (3.10, 3.12...).
- Poetry / uv: Quản lý thư viện, tự động tạo môi trường ảo một cách chuyên nghiệp.
- pyproject.toml: File cấu hình chuẩn mới cho mọi dự án Python.
Các Bước Thiết Lập Hoàn Hảo
Bước 1: Quản lý phiên bản với pyenv
Giúp cài đặt và kích hoạt đúng phiên bản Python cho từng dự án.
bash
# Cài đặt và set phiên bản local cho project
pyenv install 3.12
pyenv local 3.12
Bước 2: Tạo môi trường ảo (venv)
Cách ly thư viện của dự án này với hệ thống và các dự án khác.
bash
python -m venv .venv
source .venv/bin/activate
Bước 3: Quản lý thư viện với Poetry
Bỏ qua requirements.txt cũ kỹ, dùng Poetry để quản lý file lock an toàn tuyệt đối.
bash
# Khởi tạo và thêm thư viện
poetry new myapp
poetry add fastapi
Advertisement
Nên dùng công cụ nào?
So sánh nhanh
- venv: Mặc định của Python, dễ dùng, an toàn.
- Pipenv: Từng rất hot, nhưng hiện tại hơi chậm.
- Poetry: Phổ biến nhất hiện nay, quản lý dependencies rất tuyệt vời.
- uv: Công cụ mới bằng Rust, tốc độ siêu nhanh (nhanh gấp chục lần pip).
Cảnh Báo Dành Cho Người Mới
Tuyệt đối không dùng sudo pip install hoặc cài đặt các gói trực tiếp vào Python hệ thống. Luôn luôn dùng môi trường ảo!
Bạn cũng có thể thích
- 10 mẹo Python mình thật sự hay dùng
- Pytest từ A đến Z: Tutorial ngắn gọn để chạy test đúng và tự tin deploy
- Các mẫu Pytest Fixture và Tham số hóa nâng cao
- Thiết Kế Hệ Thống: Xây Dựng một Bộ Giới Hạn Tốc Độ Phân Tán (Distributed Rate Limiter)
Kiểm tra kiến thức
Interactive Quiz
Question 1 of 2
`pyenv local 3.12` (hoặc `uv python pin 3.12`) làm gì?
Chia sẻ bài viết:
Tiện ích lập trình viên
Công cụ lập trình trực tiếp trên trình duyệt
Làm sạch log AI CLI, tạo biểu thức cron, giải mã JWT và tính quyền chmod offline.
Advertisement
Bài viết liên quan
python
Python không dùng dấu gạch dưới như “công cụ kiểm soát truy cập”
Trong Python, dấu gạch dưới chủ yếu là quy ước đặt tên chứ không phải cơ chế riêng tư được ép buộc - hiểu đúng khác biệt sẽ tránh code gây rối.
Đọc tiếp
python
Tài liệu tham khảo Python Async & Concurrency: Event Loop, TaskGroup & Design Pattern trên Production (2026)
Tài liệu tham khảo tiêu chuẩn cho môi trường production về lập trình bất đồng bộ trong Python: cơ chế nội bộ của event loop, structured concurrency với TaskGroup, free-threaded CPython 3.13, connection pooling, và profiling event loop starvation.
Đọc tiếp
python
Tìm hiểu chuyên sâu Python Asyncio: Coroutine, Task và Event Loop vào năm 2026
Nắm vững Python asyncio vào năm 2026: Coroutine, TaskGroup so với gather, nội bộ uvloop, ngăn chặn tắc nghẽn event loop và async semaphore pooling.
Đọc tiếp