Ρύθμιση uv στο macOS

Basic python

Ρύθμιση uv στο macOS

Στόχοι #

  • Να εγκαταστήσεις Python 3.13 και uv σε macOS Ventura / Sonoma
  • Να δημιουργείς και να ενημερώνεις εικονικά περιβάλλοντα μόνος σου
  • Να τα συνδέσεις με εργαλεία όπως το VS Code

Τι χρειάζεσαι #

ΣτοιχείοΠεριγραφή
ΕργαλείαHomebrew (brew --version για έλεγχο. Αν λείπει, ακολούθησε brew.sh)
Κέλυφοςzsh (προεπιλογή) ή bash – εδώ χρησιμοποιούμε zsh
ΦάκελοςΠαράδειγμα ~/Projects/my-app

1. Εγκατάσταση Python 3.13 #

brew update
brew install python@3.13
brew link python@3.13
python3.13 --version

Αν φανεί Python 3.13.x, όλα καλά. Αν υπάρχει άλλο link, τρέξε brew unlink python@3.x.

2. Εγκατάσταση uv #

curl -LsSf https://astral.sh/uv/install.sh | sh

Έπειτα:

uv --version

Αν δεν βρεθεί η εντολή, πρόσθεσε ~/.local/bin στο PATH:

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

3. Δημιουργία φακέλου και περιβάλλοντος #

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

Με το (.venv) στο prompt γνωρίζεις ότι είναι ενεργό. Χρησιμοποίησε deactivate για έξοδο.

💡 Χωρίς ενεργοποίηση μπορείς να τρέξεις uv run python script.py και το uv θα χρησιμοποιήσει αυτόματα το περιβάλλον.

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 #

  1. Άνοιξε VS Code → Command Palette (⇧⌘P) → Python: Select Interpreter
  2. Επίλεξε .venv/bin/python ώστε οι λειτουργίες να δουλεύουν στο περιβάλλον
  3. Πρόσθεσε επεκτάσεις όπως “Python”, “Pylance”, “Black Formatter”, “Flake8 / Ruff”

6. Συνηθισμένα προβλήματα #

ΠρόβλημαΑντιμετώπιση
brew δεν αναγνωρίζεταιΕγκατέστησε Homebrew σύμφωνα με την επίσημη σελίδα
uv δεν τρέχειΠρόσθεσε PATH στο ~/.zshrc και source ~/.zshrc
Σφάλμα δικαιωμάτων κατά τη δημιουργία περιβάλλοντοςΈλεγξε άδειες φακέλου με chmod / chown και ξαναδοκίμασε

7. Καθαρισμός #

  • Έξοδος: deactivate
  • Διαγραφή περιβάλλοντος: rm -rf .venv
  • Καταγραφή πακέτων: uv pip freeze > requirements.txt

Καλώς ήρθες στον κόσμο της Python στο macOS! Συνέχισε στο επόμενο κεφάλαιο για τα βασικά της γλώσσας.