常用操作1.虚拟环境管理操作命令示例说明创建虚拟环境uv venv在当前目录创建.venv虚拟环境默认路径可指定路径uv venv ./myenv指定 Python 版本创建uv venv --python 3.12创建基于 Python 3.12 的虚拟环境需系统已安装对应版本激活虚拟环境Windows.venv\Scripts\activateLinux/macOSsource .venv/bin/activate激活后终端前缀会显示(.venv)表示进入虚拟环境删除虚拟环境rm -rf .venvLinux/macOSrmdir /s .venvWindowsUV 无专门删除命令直接删除环境目录即可2.依赖操作指令指令场景指令示例说明安装单个包uv add requests安装最新兼容版本自动写入pyproject.toml的dependencies安装指定版本uv add requests2.31.0安装固定版本避免自动升级安装版本范围uv add requests2.30,3.0安装 2.30 及以上、3.0 以下版本兼容写法安装开发依赖uv add --dev pytest安装到[project.optional-dependencies].dev仅用于开发环境批量安装从 requirements.txtuv add -r requirements.txt把requirements.txt中的依赖全部导入到pyproject.toml并安装安装可选依赖组uv add fastapi[standard]安装包含可选依赖的包如 fastapi 的 standard 扩展离线安装仅用缓存uv add requests --offline不联网仅从本地缓存安装需提前下载过该包默认缓存目录 C:\Users\用户名\AppData\Local\uv\cache创建项目和创建环境命令核心作用适用场景uv init初始化一个完整的 Python 项目新建一个基于uv的项目uv venv仅创建纯虚拟环境 (.env)只想快速建一个空的虚拟环境不需要项目配置比如临时测试uv sync将项目的依赖同步到当前虚拟环境中如果没有.env先自动创建根据依赖声明下载所有依赖