目录

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

二、用 uv 安装 Python

 三、新建并初始化项目

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

五、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