ตั้งค่า uv บน Ubuntu

เป้าหมายของหน้านี้ #

• ติดตั้ง Python 3.13 และ uv บน Ubuntu 22.04 / 24.04 LTS
• สร้างและดูแลสภาพแวดล้อมเสมือน พร้อมเพิ่ม/ซิงก์ไลบรารีได้เอง
• เข้าใจปัญหาที่พบบ่อยและรู้ว่าควรตรวจอะไรเมื่อเกิดเหตุ

ข้อกำหนด #

1. ติดตั้ง Python 3.13 #

เนื่องจาก Ubuntu ยังไม่มี Python 3.13 ใน repo มาตรฐาน ให้เพิ่ม PPA deadsnakes

sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install -y python3.13 python3.13-venv python3.13-dev python3.13-distutils
python3.13 --version

เห็น Python 3.13.x ก็พร้อมแล้ว

2. ติดตั้ง uv #

curl -LsSf https://astral.sh/uv/install.sh | sh
~/.local/bin/uv --version

ถ้าไม่เจอคำสั่งให้เพิ่ม ~/.local/bin ใน PATH

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

3. สร้างโฟลเดอร์และสภาพแวดล้อม #

mkdir -p ~/projects/my-app
cd ~/projects/my-app
uv venv --python 3.13 .venv
source .venv/bin/activate

เห็น (.venv) ในพรอมป์คือเปิดใช้งานแล้ว ใช้ deactivate เมื่อต้องการออก

💡 ไม่ต้อง activate ก็ได้ เพียงเรียก uv run python script.py

4. เพิ่ม/ซิงก์ไลบรารี #

uv pip install numpy pandas
uv pip list
uv pip sync requirements.txt

• uv pip install: เพิ่มแพ็กเกจ
• uv pip list: ตรวจรายการที่ติดตั้ง
• uv pip sync: ทำให้ตรงกับ requirements.txt

5. ใช้ร่วมกับ VS Code หรือเอดิเตอร์อื่น #

• ใน VS Code ติดตั้งส่วนขยาย “Python” แล้วกด Ctrl+Shift+P → Python: Select Interpreter → เลือก .venv/bin/python
• สำหรับ vim หรือ Neovim ให้เปิดเอดิเตอร์จากเชลล์ที่ activate ไว้

6. ปัญหาที่พบได้บ่อย #

7. เก็บงาน #

• ออกจากสภาพแวดล้อม: deactivate
• ลบสภาพแวดล้อม: rm -rf .venv
• บันทึก dependencies: uv pip freeze > requirements.txt

Ubuntu ของคุณพร้อมกับ Python 3.13 + uv แล้ว เดินหน้าต่อไปยังบทพื้นฐานของ Python กันเลย