大家好,我是云途。Python 项目最容易出现的情况,是这个项目能运行,换一台电脑却缺包;或者为了修一个项目,把另一个项目弄坏了。
解决方法不是记更多安装命令,而是让每个项目使用自己的虚拟环境和依赖说明。
解释器、包和虚拟环境是什么关系
Python 是运行代码的解释器;包是项目要用的第三方能力;.venv 是项目自己的隔离环境。uv 可以帮助创建环境、安装依赖并锁定版本。
建立第一个独立环境
uv init
uv venv
uv add requests
uv run python --version项目应保留 pyproject.toml 与锁文件,但通常不要把 .venv 提交到 Git,也不要把它复制给别人。
环境混乱后怎样恢复
- 先确认当前目录和 pyproject.toml。
- 确认命令使用的是项目内环境,不是系统 Python。
- 依赖说明完整时,可以删除并重建
.venv;不要先修改系统 Python。 - 重新运行项目的测试或最小启动命令。
Python 依赖已经留在项目内部
- 项目存在 pyproject.toml。
- 项目使用自己的 .venv。
- 依赖由 uv 记录和锁定。
- 没有把全局 Python 当作项目依赖。