快速上手python uv的核心是把它当作pip和virtualenv的替代品，直接通过命令行管理项目依赖和环境。你只需要安装uv二进制文件，然后在项目目录下使用uv init初始化项目并添加依赖，它会自动处理虚拟环境的创建与激活。相比传统方式，你无需手动配置.venv或运行source activate，所有环境隔离操作都由uv在后台静默完成，从而显著减少配置步骤。
如何初始化新项目并添加依赖
初始化新项目时，uv init命令会创建一个包含pyproject.toml的基础结构，并自动建立虚拟环境。添加依赖只需使用uv add命令，指定包名即可，uv会解析依赖树并锁定版本到uv.lock文件中。这种流程消除了手动编辑配置文件的需求，确保依赖状态的一致性。
mkdir my_project cd my_project uv init uv add requests flask uv run python -c "import requests; print(requests.__version__)"
上述代码执行后，终端将打印出requests库的版本号，证明依赖已正确安装且环境可用。如果未指定uv run，直接运行python可能无法找到新安装的包，因为默认shell环境并未自动切换至项目虚拟环境。
立即学习“Python免费学习笔记（深入）”；
如何在现有项目中管理依赖
对于已有代码的项目，uv同样适用。你可以进入项目目录，运行uv sync来根据现有的pyproject.toml和uv.lock安装所有依赖。如果需要更新某个包，使用uv add并指定新版本约束，或者使用uv remove卸载不需要的包。这种方式比pip更可靠，因为它保证了锁文件与实际安装环境完全同步。
cd existing_project uv sync uv add numpy==1.24.0 uv remove pandas
执行这些命令后，项目依赖将被精确更新。再次运行uv sync会验证当前环境与锁文件一致，任何偏差都会被纠正。这种方法特别适用于团队协作，确保所有开发者使用相同的依赖版本。
uv如何处理虚拟环境的路径与激活
在使用uv时，虚拟环境通常存储在项目的.venv目录中。与传统pip不同，uv不需要显式激活环境，而是通过uv run前缀或在IDE中配置解释器路径来使用。当你运行uv run时，它会临时激活虚拟环境并执行后续命令，执行完毕后恢复原状。这种设计简化了工作流，避免了因忘记激活环境而导致的导入错误。
