uv init可快速初始化带虚拟环境和pyproject.toml的python项目，支持指定python版本、静默模式及自动依赖管理，无需手动组合pip与venv。

用 uv 初始化新 Python 项目，能跳过 pip + venv 的繁琐组合，直接生成带虚拟环境、依赖管理、可运行结构的最小可行项目。

创建带虚拟环境和 pyproject.toml 的基础项目

在终端中进入目标目录，执行：
uv init

这一步会交互式询问项目名、Python 版本、是否初始化 Git。按回车接受默认值即可，项目名会自动从当前文件夹名推断。【若当前目录非空且不含 pyproject.toml，uv init 会拒绝执行】

执行后，uv 自动创建 pyproject.toml（含 [build-system] 和 [project] 基础字段）、.gitignore，并在 .venv 下初始化兼容当前 Python 的虚拟环境。

指定 Python 版本并跳过交互

方法一：用 --python 指定解释器路径
uv init --python /usr/bin/python3.11

方法二：用版本字符串快速匹配（需系统已安装对应版本）
uv init --python 3.12

Forge — Python Developer

Python开发助手 — 自动化脚本、API封装、命令行工具、数据管道、网页爬虫。经过测试的代码，包含错误处理和文档。当你需要...

下载

方法三：完全静默初始化（不提问、不初始化 Git、使用默认 Python）
uv init --no-git

注意：--no-git 不影响虚拟环境创建，只跳过 git init 和 .gitignore 生成。

初始化后立即添加依赖并验证环境

第一步：激活 uv 创建的虚拟环境
source .venv/bin/activate（Linux/macOS） 或 .venv\Scripts\activate.ps1（Windows PowerShell）

第二步：安装 requests 并写入 pyproject.toml 的 dependencies 字段
uv add requests

第三步：检查依赖是否已解析进环境且可导入
python -c "import requests; print(requests.__version__)"

这一步成功说明 uv init 生成的环境可正常工作，pyproject.toml 已被正确识别为项目配置源。不需要手动运行 uv sync —— uv add 会自动同步依赖到当前环境。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！