安装uv并管理 Python / 包

无语......2026-04-15 16:01

[一、windows 安装 uv、并测试是否安装成功](#一、windows 安装 uv、并测试是否安装成功)

[二、用 uv 安装 Python](#二、用 uv 安装 Python)

三、新建并初始化项目

[四、虚拟环境（uv 自带，自动管理）](#四、虚拟环境（uv 自带，自动管理）)

[五、Python 包管理（安装、卸载、查看）](#五、Python 包管理（安装、卸载、查看）)

六、运行项目

[七、项目依赖导出 / 同步](#七、项目依赖导出 / 同步)

一、windows 安装 uv、并测试是否安装成功

复制代码

# 1. win + R，输入 powershell，回车

# 2. 安装 uv
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# 3. 重启 powershell

# 4. 查看 uv 版本
uv --version

# 帮助
uv --help

二、用 uv 安装 Python

复制代码

# 安装指定 Python 版本
uv python install 3.12

# 想让系统里直接可用 python 命令，可以用
uv python install 3.12 --default

# 查看已安装的所有 Python
uv python list

# 检查python版本
python --version



# 把某个版本设为全局默认
uv python pin 3.12

# 卸载某个 Python 版本
uv python remove 3.12

# 查看当前默认 Python
uv python which

三、新建并初始化项目

复制代码

# 新建项目文件夹
mkdir my_project

cd my_project

# 在当前文件夹初始化项目
uv init

# 或者 新建并进入名为 my_project 的文件夹，再初始化
uv init my_project

初始化后生成：

复制代码

my_project/
├── .python-version  # 记录项目用的 Python 版本
├── README.md        # 项目说明文档
├── main.py          # 入口脚本（自带 Hello World）
└── pyproject.toml   # 核心配置文件（项目名、依赖、版本等）

四、虚拟环境（uv 自带，自动管理）

复制代码

# 在当前文件夹创建虚拟环境（自动生成 .venv文件夹）
uv venv

五、Python 包管理（安装、卸载、查看）

复制代码

# 安装包（最快）
uv add requests

# 安装指定版本
uv add requests==2.31.0

# 卸载包
uv remove requests

# 查看已安装的所有包
uv pip list

# 查看某个包信息
uv pip show requests

六、运行项目

复制代码

# 直接运行 Python 文件
uv run main.py

# 进入 Python 交互环境
uv run python

七、项目依赖导出 / 同步

复制代码

# 生成依赖文件 requirements.txt
uv pip freeze > requirements.txt

# 从 requirements.txt 安装所有依赖
uv pip install -r requirements.txt