uv venv 实战从零到隔离环境 30 秒Python 版本自动搞定【免费下载链接】uvAn extremely fast Python package and project manager, written in Rust.项目地址: https://gitcode.com/GitHub_Trending/uv/uv一个项目钉死在 3.11另一个非要 3.12系统 Python 两头都切不过去virtualenv 每建一个环境都要干等一会儿。uv venv 把这个痛点压成一条命令.venv立刻就绪指定的 Python 版本机器上没有就直接下载。下面按日常流程走装 uv、建环境、激活、锁定版本。从零到第一个可用的 .venvLinux / macOS 安装一条命令装 uv装完顺手验证一下curl -LsSf https://astral.sh/uv/install.sh | sh uv --versionWindows 安装PowerShell 里一条命令powershell -c irm https://astral.sh/uv/install.ps1 | iex一条命令建好 .venv在项目目录里执行当前目录下就出现.venvuv venv # 换个名字或路径也行 uv venv myenv如果你习惯python -m venv命令可以原样替换uv 就是当 venv 的替代品在用只是速度快一个量级。装完环境后往里装包直接uv pip install 包名就行后面会用到。uv 快的原因不只是语言缓存机制也省掉了重复下载创建时指定 Python 版本-p是--python的简写格式不用死记能写对下面几种就够用uv venv -p 3.11 # 任意一个 3.11.x uv venv -p 3.12.3 # 精确到补丁版本 uv venv -p cpython3.12 # 指定实现cp / pypy / graalpy 都可以指定的版本本机没有时uv 会先下载再建环境不用手动装 Python。激活、运行与自动发现激活就是把终端里的python指到环境内部按 shell 选对应脚本。bash / zshsource .venv/bin/activatefishsource .venv/bin/activate.fishcsh / tcshsource .venv/bin/activate.cshnushelluse .venv/bin/activate.nuWindows CMD.venv\Scripts\activate.batPowerShell.venv\Scripts\Activate.ps1激活成功后提示符前会出现(.venv)。干完活想退出敲deactivate就行所有 shell 通用。不激活直接跑uv run日常其实经常不用激活。uv run会自己找到环境并在其中执行命令uv run python script.py uv run pip list这也是为什么团队协作时不用纠结你有没有激活——只要.venv在结果就是可复现的。uv 怎么找到环境查找顺序就三条已激活的环境VIRTUAL_ENV环境变量当前目录及其父目录里的.venvuv run所在项目目录有pyproject.toml对应的.venv版本管理深水区查、预装、锁定看一眼有哪些版本可用交互式选版本前先摸底3.12和pypy都是过滤条件uv python list uv python list 3.12 uv python list pypy预装指定版本不想在建环境时才触发下载就提前装好uv python install 3.11顺带说一句uv python upgrade 3.12可以把 uv 管理的版本升到最新补丁版3.12.1 → 3.12.3不跨小版本也不支持 PyPy 等实现。锁定项目的 Python 版本两个文件解决两类问题建议都放进仓库.python-version在项目根目录放一个纯文本文件内容就一行版本号比如3.12.3。在该目录及子目录里跑任何 uv 命令都会优先按它选解释器。uv.toml用python-preference控制 uv 在系统 Python和uv 下载的 Python之间怎么取舍python-preference only-system四个取值的差别managed默认uv 下载的版本优先但系统已有的同版本仍优先用系统的、only-managed禁用系统 Python、system系统优先、only-system完全不让 uv 下载。公司内网机器装不上外部 Python 时改这一行最省事。缓存看一眼、清一下Python 发行版和下载的包都缓存在本地目录位置与清理各一条命令uv cache dir uv cache clean卡住了三个高频坑PowerShell 拒绝执行激活脚本症状报无法加载文件 ...Activate.ps1因为在此系统上禁止运行脚本。原因Windows 默认执行策略是Restricted。修复Set-ExecutionPolicy -Scope CurrentUser RemoteSigneduv run 没走 .venv症状.venv明明存在uv run却慢得像冷启动解释器版本也不对。原因目录里没有pyproject.tomluv 不认这是个项目直接建了临时环境。修复uv init生成pyproject.toml后uv run就会走.venv。-p指定的版本满足不了症状uv venv -p 3.13报找不到解释器。原因要么这个版本号不存在要么当前网络拉不到下载源。修复uv python list先确认要装的版本真实存在再手动uv python install一遍能单独定位是网络问题还是版本号写错。IDE 还在用系统解释器跑代码的话把 PyCharm 或 VS Code 的解释器指到.venv/bin/pythonWindows 是.venv\Scripts\python.exe即可环境本身不用动。uv venv 的价值一句话建环境一条命令版本一条命令。更多细节见 first-steps.md。【免费下载链接】uvAn extremely fast Python package and project manager, written in Rust.项目地址: https://gitcode.com/GitHub_Trending/uv/uv创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考