uv パッケージマネージャーで、既存の [[Python]] プロジェクトのバージョンを変更する場合は、以下のコマンドを実行する。
```bash
uv python pin 3.14
#> Updated `.python-version` from `3.12` -> `3.14`
```
```bash
cat .python-version
#> 3.14
```
```bash
cat pyproject.toml
#> [project]
#> name = "project-name"
#> version = "0.1.0"
#> description = "Add your description here"
#> readme = "README.md"
#> requires-python = ">=3.12"
#> dependencies = []
```
> [!note]
> このコマンドでは、`requires-python` は変更されない
> [!tip]
> 本番環境では `.python-version` と `requires-python` を一致させることで、環境差異による問題を防ぐことができる。
## 関連ノート
- **[前提]** [[uv で Python プロジェクトを新規作成する]]: 本ノートの `uv python pin` は既存の uv プロジェクトに対して使う操作
- **[前提]** [[uv を macOS にインストールする]]: 本ノートの操作は uv がインストール済みであることが前提
- **[派生]** [[実行中の Python のバージョンを確認する]]: 変更前に現状を把握したいときに併用する
- **[派生]** [[mise と uv で Python をグローバルとプロジェクトで使い分ける]]: プロジェクト単位のランタイム変更がどこに位置づくかを理解するため併読する