Python 虚拟环境与依赖管理最佳实践

举报
yd_278762296 发表于 2026/11/18 06:07:29 2026/11/18
【摘要】 用 venv 隔离环境、requirements.txt 锁定版本,配合 pip-tools 管理依赖,本文给出可直接落地的做法与避坑要点,让 Python 项目环境一致、可复现。

为什么要隔离环境

不同项目的依赖版本经常互相冲突,装在全局解释器里容易出现“本地能跑、线上报错”。虚拟环境为每个项目提供独立的解释器与库目录,是环境一致的第一步。

创建与激活

标准库 venv 无需额外安装,进入项目目录执行:

python -m venv .venv
source .venv/bin/activate   # Linux/macOS
.venv\Scripts\activate      # Windows

激活后提示符出现 .venv,pip 安装的包只影响当前项目。

依赖管理要点

  • 锁定版本:导出依赖清单并提交仓库,团队与线上保持一致。
  • 区分依赖层级:手写 requirements.in 只记录直接依赖,用 pip-tools 生成带完整版本号的 requirements.txt。
  • 定期清理:升级或删除功能后用 pip check 排查冲突,避免残留旧包。
  • 不提交 .venv:把该目录写进 .gitignore,仓库只保留清单。
  • pip install pip-tools
    pip-compile requirements.in
    pip-sync requirements.txt
    

    常见坑

    用 pip freeze 直接生成清单会把间接依赖一并写死,升级时难维护;忘记激活环境就执行 pip install,包装到了全局;多个项目共用一个环境,改一次版本全乱。

    可操作建议:现在就为项目建好 .venv,依赖写入 requirements.txt 并提交仓库,CI 与部署一律从清单安装。

    【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
    • 点赞
    • 收藏
    • 关注作者

    评论(0)

    0/1000
    抱歉,系统识别当前为高风险访问,暂不支持该操作

    全部回复

    上滑加载中

    设置昵称

    在此一键设置昵称,即可参与社区互动!

    *长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

    *长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。