Python pip ติดตั้งไลบรารี



standard library ครอบคลุมงานทั่วไปได้เยอะ แต่พองานเฉพาะทางขึ้น เช่น เรียก API, ทำเว็บ, วิเคราะห์ข้อมูล เราต้องพึ่งไลบรารีจากภายนอก ซึ่งอยู่บนคลังกลางชื่อ PyPI (Python Package Index) และเครื่องมือที่ดึงมาติดตั้งคือ pip

⚠️ ก่อนพิมพ์ pip install ตามบทนี้จริง ให้สร้าง virtual environment (บทที่ 24) ก่อน แล้ว activate ให้ขึ้น (.venv) หน้าบรรทัดคำสั่ง จากนั้นค่อยติดตั้งไลบรารี ถ้า pip install โดยไม่มี venv ไลบรารีจะไปกองรวมกับ Python หลักของเครื่อง ทุกโปรเจกต์ปนกัน พอเวอร์ชันชนกันจะแก้ยากมาก บทนี้ปูให้เข้าใจว่า pip ทำงานอย่างไร ส่วนการลงมือติดตั้งจริงควรทำในบทหน้า — ถ้าอยากเรียงให้ถูกลำดับ อ่านบทที่ 24 ก่อนแล้วค่อยกลับมาบทนี้ก็ได้

เช็คว่ามี pip ไหม

pip มากับ Python รุ่นใหม่อยู่แล้ว เปิดเทอร์มินัล (ไม่ใช่ใน Python) แล้วพิมพ์

pip --version

ถ้าไม่เจอ ลองใช้ pip3 หรือ python -m pip --version

คำสั่ง pip ทั้งหมดในบทนี้พิมพ์ในเทอร์มินัล/command prompt ไม่ใช่ในโปรแกรม Python

ติดตั้งไลบรารี

pip install requests

ติดตั้งเวอร์ชันเจาะจง

pip install requests==2.31.0
pip install "requests>=2.28,<3.0"

ติดตั้งหลายตัวพร้อมกัน

pip install requests beautifulsoup4 pandas

พอติดตั้งแล้ว ในโค้ด Python เรียกใช้ได้เลย

import requests

response = requests.get("https://api.github.com")
print(response.status_code)   # 200

คำสั่งที่ใช้บ่อย

pip list                    # ดูไลบรารีที่ติดตั้งทั้งหมด
pip show requests           # ดูรายละเอียดตัวหนึ่ง
pip install --upgrade requests   # อัปเกรดเป็นเวอร์ชันล่าสุด
pip uninstall requests      # ถอนออก
pip install --upgrade pip   # อัปเกรดตัว pip เอง

ชื่อตอนติดตั้ง กับ ชื่อตอน import อาจไม่ตรงกัน

จุดที่คนใหม่งงบ่อย

ติดตั้งด้วยimport ด้วย
pip install beautifulsoup4import bs4
pip install pillowimport PIL
pip install scikit-learnimport sklearn
pip install python-dateutilimport dateutil

ดูหน้าเอกสารของไลบรารีเสมอว่าต้อง import ชื่ออะไร

requirements.txt: บันทึกรายการไลบรารี

เวลาแชร์โปรเจกต์ให้คนอื่น หรือย้ายเครื่อง เราอยากให้เขาติดตั้งไลบรารีชุดเดียวกัน วิธีมาตรฐานคือไฟล์ requirements.txt

สร้างจากสภาพแวดล้อมปัจจุบัน

pip freeze > requirements.txt

ไฟล์จะหน้าตาประมาณนี้

beautifulsoup4==4.12.3
certifi==2024.7.4
charset-normalizer==3.3.2
requests==2.31.0

คนที่รับโปรเจกต์ไปติดตั้งทั้งชุดด้วย

pip install -r requirements.txt

ในทางปฏิบัติ หลายทีมเขียน requirements.txt เองโดยใส่เฉพาะไลบรารีหลักที่ใช้จริง ไม่รวมพวก dependency ย่อย (ไลบรารีที่ไลบรารีของเราไปเรียกใช้อีกที) เพื่อให้อ่านง่าย

requests
beautifulsoup4
pandas>=2.0

pip กับ virtual environment

ถ้ารัน pip install เฉย ๆ ไลบรารีจะไปติดตั้งรวมกันที่ Python ของเครื่อง ทุกโปรเจกต์ใช้ปนกันหมด ซึ่งเป็นปัญหาเมื่อโปรเจกต์ A ต้องการ pandas 1.5 แต่โปรเจกต์ B ต้องการ pandas 2.1

ทางแก้คือสร้างสภาพแวดล้อมแยกต่อโปรเจกต์ด้วย venv (บทถัดไป) แล้วค่อย pip install ในนั้น ทำให้ไลบรารีของแต่ละโปรเจกต์ไม่ปนกัน

คำแนะนำ: สร้าง virtual environment ก่อนเสมอ แล้วค่อยติดตั้งไลบรารี อย่า pip install ลงเครื่องตรง ๆ นอกจากเป็นเครื่องมือ command-line ที่อยากใช้ทั้งเครื่อง

เตือน: อย่า sudo pip install

บนเครื่อง Mac/Linux อย่าใช้ sudo pip install เพราะไปยุ่งกับ Python ของระบบ อาจทำให้ระบบพัง ใช้ virtual environment หรือ pip install --user แทน

ตัวอย่าง: ลองติดตั้งและใช้ rich

rich เป็นไลบรารีทำให้ข้อความในเทอร์มินัลสวยขึ้น

pip install rich
from rich import print
from rich.table import Table

table = Table(title="รายการสินค้า")
table.add_column("สินค้า")
table.add_column("ราคา", justify="right")
table.add_row("กาแฟ", "45")
table.add_row("ชา", "40")

print(table)

เช็คความเข้าใจก่อนข้ามบท

  • ติดตั้งไลบรารีด้วย pip install และบันทึกลง requirements.txt ได้
  • รู้ว่าชื่อแพ็กเกจตอน install อาจไม่ตรงกับชื่อตอน import
  • อธิบายได้ว่าทำไมควรใช้ pip คู่กับ virtual environment

สรุป

  • pip install ชื่อ ดึงไลบรารีจาก PyPI มาติดตั้ง, pip uninstall ถอน
  • ชื่อตอนติดตั้งกับตอน import อาจต่างกัน ดูเอกสารเสมอ
  • pip freeze > requirements.txt และ pip install -r requirements.txt ใช้แชร์รายการไลบรารี
  • สร้าง virtual environment ก่อนติดตั้งไลบรารีเสมอ

บทถัดไปว่าด้วยการสร้าง virtual environment ด้วย venv