0

0

Python 本地开发环境最佳实践

舞夢輝影

舞夢輝影

发布时间:2026-02-26 19:55:34

|

477人浏览过

|

来源于php中文网

原创

python本地开发环境的核心是隔离、可复现和轻量,通过venv创建项目级虚拟环境,用pyproject.toml或requirements.txt声明依赖,配合black、ruff、pytest等工具实现高效开发。

python 本地开发环境最佳实践

Python 本地开发环境的核心是隔离、可复现和轻量——用 venv + pip 搭建干净的项目级环境,配合 requirements.txtpyproject.toml 管理依赖,避免全局污染和版本冲突。

用 venv 创建项目专属环境

Python 3.3+ 自带 venv,无需额外安装。在项目根目录执行:

  • python -m venv .venv —— 创建名为 .venv 的隔离环境(推荐用隐藏文件夹,避免误提交)
  • source .venv/bin/activate(macOS/Linux)或 .\.venv\Scripts\activate(Windows)—— 激活环境
  • 激活后命令行前缀会出现 (.venv),此时 pip install 安装的包仅对该项目生效

明确声明依赖,拒绝“pip freeze > requirements.txt”式操作

直接导出当前环境所有包(含间接依赖)会导致 requirements.txt 过于宽泛、难以维护。更合理的方式是:

睿拓智能网站系统-网上商城
睿拓智能网站系统-网上商城

睿拓智能网站系统-网上商城1.0免费版软件大小:5M运行环境:asp+access本版本是永州睿拓信息专为电子商务入门级用户开发的网上电子商城系统,拥有产品发布,新闻发布,在线下单等全部功能,并且正式商用用户可在线提供多个模板更换,可实现一般网店交易所有功能,是中小企业和个人开展个人独立电子商务商城最佳的选择,以下为详细功能介绍:1.最新产品-提供最新产品发布管理修改,和最新产品订单查看2.推荐产

下载
  • pip install -e . 安装本项目(需有 setup.py 或 pyproject.toml),再用 pip list --format=freeze > requirements.txt 导出顶层依赖
  • 或直接使用现代方式:在 pyproject.toml 中声明 [project.dependencies],工具如 pip-tools 可生成锁定版 requirements.txt
  • 始终把 requirements.txt 提交到 Git,但排除 .venv/__pycache__/ 等目录

编辑器与环境联动要自动识别

VS Code 和 PyCharm 都能自动发现 .venv 并启用对应 Python 解释器,但需注意:

立即学习Python免费学习笔记(深入)”;

  • VS Code:打开文件夹后,按 Ctrl+Shift+P → “Python: Select Interpreter”,选中 .venv/bin/python(或 Scripts\python.exe)
  • PyCharm:新建项目时选择 “New environment using Virtualenv”,路径设为项目内 .venv;已有项目可在 Settings → Project → Python Interpreter 中点击齿轮 → “Add…” → 选择现有环境
  • 确保编辑器终端也继承了激活的环境(VS Code 默认开启 “Python › Terminal: Execute In File Dir”,可避免手动 activate)

小而必要的工具链补充

基础环境之上,加几个高频实用工具即可覆盖大多数日常开发场景:

  • black(代码格式化):pip install black,保存时自动格式化,团队无需争论缩进空格
  • ruff(快如闪电的 linting):替代 flake8 + isort + pydocstyle,支持一键修复,pip install ruff
  • pytest(测试):比 unittest 更简洁,pip install pytest,写 test_*.py 文件即可运行
  • 全部装入 .venv 内,不污染系统,且可随项目一起迁移

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

351

2023.10.09

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

428

2024.12.20

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

790

2024.12.23

python升级pip
python升级pip

本专题整合了python升级pip相关教程,阅读下面的文章了解更多详细内容。

363

2025.07.23

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

866

2023.07.31

python中的format是什么意思
python中的format是什么意思

python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

452

2024.06.27

自建git服务器
自建git服务器

git服务器是目前流行的分布式版本控制系统之一,可以让多人协同开发同一个项目。本专题为大家提供自建git服务器相关的各种文章、以及下载和课程。

916

2023.07.05

git和svn的区别
git和svn的区别

git和svn的区别:1、定义不同;2、模型类型不同;3、存储单元不同;4、是否拥有全局版本号;5、内容完整性不同;6、版本库不同;7、克隆目录速度不同;8、分支不同。php中文网为大家带来了git和svn的相关知识、以及相关文章等内容。

575

2023.07.06

Golang 实际项目案例:从需求到上线
Golang 实际项目案例:从需求到上线

《Golang 实际项目案例:从需求到上线》以真实业务场景为主线,完整覆盖需求分析、架构设计、模块拆分、编码实现、性能优化与部署上线全过程,强调工程规范与实践决策,帮助开发者打通从技术实现到系统交付的关键路径,提升独立完成 Go 项目的综合能力。

1

2026.02.26

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.5万人学习

Django 教程
Django 教程

共28课时 | 4.6万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号