Linuxでのuv入門：Python環境構築とパッケージ管理の使い方

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

wget -qO- https://astral.sh/uv/install.sh | sh

brew install uv

pip install uv
# または
pipx install uv

uv --version
# 例: uv 0.7.x

# 新しいプロジェクトを作成
uv init myproject
cd myproject

# 以下が自動生成される:
# pyproject.toml（メタデータ）
# .python-version（Pythonバージョンの指定）
# main.py（starterスクリプト）

# インストール可能なPythonバージョンの一覧を表示
uv python list

# 特定のバージョンをインストール
uv python install 3.12
uv python install 3.11

# プロジェクトで使用するPythonバージョンを固定
uv python pin 3.12

# .python-versionファイルに書き込まれる

# 仮想環境を作成（.venvディレクトリが自動生成）
uv venv

# Linux/macOSでのアクティベーション
source .venv/bin/activate

# パッケージのインストール
pip install flask

# アクティベーション解除
deactivate

# パッケージを追加（pyproject.tomlとuv.lockが自動更新される）
uv add requests
uv add "fastapi>=0.100.0"
uv add "django~=4.2"

# 環境を同期
uv sync

# スクリプトを実行（仮想環境が自動で作成され、依存関係が同期される）
uv run main.py

# 単一パッケージのインストール
uv pip install flask

# requirements.txtからのインストール
uv pip install -r requirements.txt

# パッケージのアップグレード
uv pip install --upgrade flask

# インストール済みパッケージの一覧表示
uv pip list

# requirements.txtの生成
uv pip freeze > requirements.txt

# 依存関係の解決（ロックファイル生成）
uv pip compile requirements.txt -o requirements.lock

# ロックファイルに基づいて環境を同期
uv pip install -r requirements.lock

# 基本的な実行（仮想環境が自動で有効化される）
uv run main.py

# Pythonスクリプトの引数を渡す
uv run python script.py --arg value
# または
uv run main.py arg1 arg2

# 異なるPythonバージョンを指定して実行
uv run --python 3.11 main.py

# 1. プロジェクト作成
uv init myproject
cd myproject

# 2. パッケージ追加
uv add requests beautifulsoup4

# 3. 環境の同期
uv sync

# 4. スクリプト実行（仮想環境が自動で有効化される）
uv run main.py

# 5. 依存関係を更新したい場合
uv add "requests>=2.31.0"
uv sync     # uv.lockを更新して環境を再同期

# 6. 別の環境へエクスポート
uv export > requirements.txt

uv init myproject       # プロジェクト作成
cd myproject

uv add requests                         # 単一パッケージ
uv add "fastapi>=0.100.0"               # バージョン指定
uv add "django~=4.2"                    # 互換バージョン指定
uv add black pytest --group test        # グループ指定（dev依存）

uv sync          # uv.lockに基づいて.venvを同期
uv lock          # ロックファイルのみを更新（環境は変更しない）

uv run python script.py           # スクリプト実行
uv run pytest                     # テスト実行
uv run --python 3.12 flask run    # 特定のPythonバージョンで実行

uv python list                    # インストール済み/利用可能な一覧
uv python install 3.12            # 特定バージョンをインストール
uv python pin 3.12                # プロジェクトでの使用バージョンを固定
uv python find ">=3.10,<3.13"    # 条件に合うPythonを検索

uv pip compile requirements.txt -o requirements.lock   # 依存関係解決+ロック
uv pip install -r requirements.lock                    # ロックから環境を作成
uv pip sync requirements.txt                           # 環境をrequirements.txtに同期

uv venv                         # .venvディレクトリに仮想環境を作成
uv venv --python 3.11           # 特定Pythonバージョンで仮想環境を作成
source .venv/bin/activate       # Linuxでのアクティベート

uv add requests                         # 単一パッケージ
uv add "fastapi>=0.100.0"               # バージョン指定
uv add "django~=4.2"                    # 互換バージョン指定
uv add black pytest --group test        # グループ指定（dev依存）

uv sync          # uv.lockに基づいて.venvを同期
uv lock          # ロックファイルのみを更新（環境は変更しない）

uv run python script.py           # スクリプト実行
uv run pytest                     # テスト実行
uv run --python 3.12 flask run    # 特定のPythonバージョンで実行

# Bash
uv generate-shell-completion bash > /etc/bash_completion.d/uv

# Zsh
uv generate-shell-completion zsh > ~/.zsh/_uv
source ~/.zsh/_uv

# Ubuntu/Debian apt経由（公式リポジトリが利用可能な場合）
sudo apt install uv

# Fedora
sudo dnf install uv

FROM python:3.12-slim
RUN curl -LsSf https://astral.sh/uv/install.sh | sh
WORKDIR /app
COPY pyproject.toml uv.lock ./
RUN /root/.local/bin/uv sync --frozen --no-install-project
COPY . .
RUN /root/.local/bin/uv sync --frozen
CMD ["/root/.local/bin/uv", "run", "python", "main.py"]

uv init          # プロジェクト作成
uv add <pkg>     # パッケージ追加
uv sync          # 環境同期
uv run <script>  # スクリプト実行