讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

Laper
Laper

剧本策划到成片协作

剧云
剧云

中文短剧剧本制作平台

立刻MV
立刻MV

低成本歌曲 MV、视频生成

Python 函数设计中的防御式策略

阿辰吖_1210

阿辰吖_1210

发布时间:2026-02-20 18:27:45

|

926人浏览过

|

来源于php中文网

原创

该做函数参数校验,但应避免用 isinstance 硬拦,优先检查明显错误并早抛出清晰提示;可变默认参数须用 None 初始化;意外错误 raise,业务分支返回 None 或标记值;@lru_cache 仅用于输入稳定、可哈希且内存可控场景。

python 函数设计中的防御式策略

函数参数类型校验该不该做?

该做,但别用 isinstance 硬拦——它在泛型、Union 和鸭子类型场景下容易误杀,也破坏可扩展性。真正要防的是“明显错”,比如传了 None 却要求非空字符串,或传了字典却预期是列表。

  • 优先用「早抛出 + 清晰提示」:检查关键约束(如 if not isinstance(x, str) or not x.strip()),直接 raise ValueError("name must be a non-empty string")
  • 避免对整个参数结构做深度校验(比如递归检查嵌套 dict 的每个 key),这会让函数难以测试和 mock
  • 如果项目已用 typing,配合 pydantic 或 typeguard 做运行时校验更稳妥,但注意它们会带来启动开销

如何安全处理可变默认参数?

所有用 list、dict、set 作默认值的写法,本质都是共享同一个对象引用——下次调用时,它可能已被上次修改过。

  • 统一改用 None 作为默认值,再在函数体内初始化:def append_item(items=None): items = items or []
  • 注意 or 在 items=[] 时仍为真,所以更严谨写法是 items = [] if items is None else items
  • 如果函数需要保留历史状态(比如缓存),那就明确承认这是有意设计,并在 docstring 里写清「此参数为可变对象,调用者需自行管理生命周期」

错误处理该 raise 还是返回 None/False?

取决于错误性质:意外情况(如网络中断、文件被删)必须 raise;预期中的业务分支(如用户未找到)更适合返回 None 或专用标记值(如 dataclasses.MISSING)。

Python Hardener
Python Hardener

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

下载
  • 不要把所有异常都吞掉再 return None——这会让调用方无法区分「没结果」和「出错了」
  • 避免用 return False 表示失败,尤其当函数本就应返回布尔值时,语义完全冲突
  • 如果多个错误路径共用同一异常类型(如都抛 ValueError),至少通过 message 区分,或者自定义子类(如 InvalidConfigError)

要不要给函数加 @lru_cache?

只在确认「输入稳定、输出不变、内存可控」时才加。盲目缓存反而引入隐蔽状态,让调试变难。

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

  • 检查输入是否含不可哈希类型(如 dict、list、自定义对象)——会直接报 TypeError: unhashable type
  • 缓存键基于参数值而非对象身份,所以两个内容相同但地址不同的 dataclass 实例会被视为不同键,除非你显式实现 __hash__
  • 缓存大小不设限(maxsize=None)时,若输入组合多且分散,可能吃光内存;建议先用 maxsize=128 观察命中率
防御式设计最常被忽略的点,其实是「假设调用方会读文档」。实际中,很多人只看函数名和参数名就开写。所以关键约束得写进 signature(比如用 Optional[str])、错误信息得带具体值(比如 f"expected int > 0, got {n}"),而不是依赖 docstring。

热门AI工具

更多
函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

豆包大模型

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

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

咔片AIPPT

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

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

DeepSeek

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

WorkBuddy

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

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

7479

2023.08.02

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

7479

2023.08.02

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1918

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

3164

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

6384

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

6529

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

8054

2024.03.22

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

12474

2024.04.29

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

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

0

2026.11.12

热门下载

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

精品课程

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

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