เป้าหมายของหน้านี้ #
- ติดตั้ง Python 3.13 บน Windows 11 / 10
- ใช้
uvกับvenvเพื่อสร้างและจัดการสภาพแวดล้อมเสมือนได้ - รู้ทันจุดที่พบบ่อยและวิธีแก้
ข้อกำหนดเบื้องต้น #
| รายการ | รายละเอียด |
|---|---|
| สิทธิ์ | บัญชีผู้ใช้ปกติก็พอ (อนุญาตรันสคริปต์ชั่วคราวด้วย Set-ExecutionPolicy) |
| เชลล์ | Windows PowerShell (พิมพ์ “PowerShell” ใน Start menu) |
| โฟลเดอร์งาน | ใช้ตัวอย่าง C:\projects\my-app (เปลี่ยนได้ตามใจ) |
1. ติดตั้ง Python 3.13 #
ดาวน์โหลด
Windows installer (64-bit)จาก หน้าอย่างเป็นทางการเปิดโปรแกรมติดตั้ง ทำเครื่องหมาย “Add python.exe to PATH” แล้วกด
Install Nowตรวจสอบเวอร์ชันใน PowerShell
py -3.13 --versionหากเห็น
Python 3.13.xแสดงว่าพร้อมใช้งาน ถ้าpyไม่ถูกจำ ให้ปิด PowerShell แล้วเปิดใหม่
💡 จะใช้
winget install Python.Python.3.13ก็ได้ แต่อย่าลืมตรวจสอบ PATH
2. ติดตั้ง uv #
uv คือแพ็กเกจเมเนเจอร์ที่รวดเร็ว รันคำสั่งด้านล่างใน PowerShell
Set-ExecutionPolicy -Scope Process Bypass
iwr https://astral.sh/uv/install.ps1 -UseBasicParsing | iex
uv --version
ถ้ามีหมายเลขเวอร์ชันขึ้น แปลว่าติดตั้งสำเร็จ หากไม่ขึ้น ให้เปิด PowerShell ใหม่หรือเช็กว่า $Env:USERPROFILE\.local\bin อยู่ใน PATH
3. สร้างโฟลเดอร์โปรเจ็กต์และสภาพแวดล้อมเสมือน #
mkdir C:\projects\my-app
cd C:\projects\my-app
uv venv --python 3.13 .venv
คำสั่งนี้จะสร้าง .venv ให้เปิดใช้ด้วย:
.\.venv\Scripts\Activate.ps1
เมื่อเห็น (.venv) นำหน้าพรอมป์ แปลว่าสภาพแวดล้อมถูกเปิด ใช้ deactivate เพื่อออก
✁Eไม่เปิดใช้งานก็ได้ ใช้
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. ตั้งค่า Visual Studio Code (ทางเลือก) #
- เปิด VS Code แล้วเลือกตัวแปล Python จากแถบสถานะ
- ชี้ไปที่
.venv\Scripts\python.exeเพื่อให้การเติมคำและดีบักผูกกับสภาพแวดล้อม - แนะนำให้ติดตั้งส่วนขยาย “Python”, “Pylance”, “Black Formatter” เป็นต้น
6. ปัญหาที่พบบ่อยและวิธีแก้ #
| อาการ | วิธีแก้ |
|---|---|
Set-ExecutionPolicy ถูกปฏิเสธ | ตรวจสิทธิ์ หรือเปิด PowerShell แบบ “Run as administrator” |
หาคำสั่ง uv ไม่เจอ | เปิด PowerShell ใหม่ / เพิ่ม $Env:USERPROFILE\.local\bin ใน PATH |
ลบ .venv ไม่ได้ | ปิด VS Code หรือแอปที่ใช้งานอยู่ แล้วลองลบอีกครั้ง |
7. เก็บกวาด #
- ออกจากสภาพแวดล้อม:
deactivate - ลบสภาพแวดล้อม: ลบโฟลเดอร์
.venv - บันทึกรายการแพ็กเกจ:
uv pip freeze > requirements.txt
ตอนนี้คุณมี Python 3.13 + uv พร้อมบน Windows แล้ว ไปบทถัดไปเพื่อเริ่มเรียนพื้นฐาน Python ได้เลย