讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

立刻MV
立刻MV

低成本歌曲 MV、视频生成

Laper
Laper

剧本策划到成片协作

剧云
剧云

中文短剧剧本制作平台

Python 工程复杂度的控制策略

大静君_6998

大静君_6998

发布时间:2026-02-23 19:02:03

|

703人浏览过

|

来源于php中文网

原创

模块拆分应避免过早创建utils目录,需待业务逻辑稳定后再提取无状态、跨域通用代码并严格约束;可选依赖须按场景分组、加版本约束,禁用无版本声明。

python 工程复杂度的控制策略

模块拆分时,别过早抽象出 utils 目录

很多团队一上手就建 utils,结果半年后里面塞了 83 个函数,彼此依赖混乱,改一个 format_timestamp 能让测试挂掉三个服务。这不是复用,是债务打包。

实操建议:

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

  • 先让功能在业务模块里“长出来”——比如 order_processing.py 里反复出现的校验逻辑,再考虑抽成 order_validation.py
  • utils 只收真正无状态、无业务语义、跨域通用的代码(如 parse_iso_datetime),且必须带类型注解和单测
  • 一旦某个 utils 函数被两个以上不相关的业务模块导入,立刻检查它是否隐含了未声明的上下文依赖(比如悄悄读了 os.environ)

pyproject.toml 里别堆满可选依赖

看到别人写 dev = ["pytest", "black", "mypy", "pre-commit", ...] 就照抄,结果 CI 构建时 pip 解析依赖图耗时翻倍,本地 poetry install 卡住还查不出原因。

实操建议:

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

  • 按场景分组:只把真正在开发期用的放 dev;CI 专用工具(如 coveralls)单独设 ci 组;文档生成类(sphinx)归 docs
  • 所有可选依赖必须加版本约束,禁止 "black" 这种写法,用 "black>=24.0.0,
  • CI 脚本里显式指定安装组:pip install ".[ci]",避免 pip 自动合并多个组引发冲突

类型提示不是装饰,是接口契约

加了 def process(data: dict) -> List: 等于没加——dict 和 List 不提供任何校验或 IDE 支持,运行时照样传错结构崩掉。

Python Hardener
Python Hardener

通过完整的安全审查、代码整洁重构、健壮的错误处理、正确的日志记录以及完整的文档字符串覆盖,强化 Python 脚本。

下载

实操建议:

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

  • 用 TypedDict 或 Pydantic v2 的 BaseModel 描述数据形状,哪怕只是临时验证;dataclass 更适合内部状态封装
  • 函数参数/返回值类型必须精确到具体字段级约束(如 Optional[str] 而非 Any),否则 mypy 会绕过检查
  • 类型检查要跑在 CI 里,但别用 mypy --strict 一步到位——先从 --disallow-untyped-defs 和 --disallow-incomplete-defs 开始,逐步收紧

测试不是覆盖率数字,是隔离边界的探测器

追求 90%+ 覆盖率后发现,test_order_creation 里 mock 了数据库、HTTP 客户端、时间模块,最后这个测试既慢又脆,重构一次就得重写三处 patch。

实操建议:

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

  • 单元测试只打穿一层:函数输入 → 函数输出,其他依赖全用真实轻量对象(如内存字典代替 DB,httpx.MockTransport 代替 requests-mock)
  • 集成测试才该启动真实依赖,但必须限定范围——比如只测 OrderService + 内存 SQLite,不拉起 Redis 或外部 API
  • 每个测试文件开头加注释说明它验证的边界:# 验证订单金额计算在税费变更时仍正确,而不是 # 测试 order module

复杂度真正的麻烦不在代码行数,而在你改一行时,得翻几个文件、问几个人、猜三次意图。控制不住这点,再多的架构图和规范都只是延缓爆炸的时间。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

相关专题

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

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

3650

2023.10.09

更新pip版本
更新pip版本

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

8303

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、保存并关闭文件即可。

10022

2024.12.23

python升级pip
python升级pip

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

5307

2025.07.23

堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

7107

2023.07.18

堆和栈区别
堆和栈区别

堆(Heap)和栈(Stack)是计算机中两种常见的内存分配机制。它们在内存管理的方式、分配方式以及使用场景上有很大的区别。本文将详细介绍堆和栈的特点、区别以及各自的使用场景。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

2908

2023.08.10

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

120

2026.11.12

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

100

2026.11.12

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

60

2026.11.12

热门下载

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

精品课程

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn