示例工程教程【免费下载链接】materialsBonus materials, exercises, and example projects for our Python tutorials项目地址https://gitcode.com/gh_mirrors/ma/materials点击查看免费下载本文以开源仓库 materials 中 what-does-arrow-mean-in-python 目录的 7 个可运行示例文件为主线系统讲解 Python 函数定义中-符号的含义与用法。读完本文你将掌握返回类型注解return type annotation的完整语法、int/str/float/None/dict等常见写法、注解只声明、不强制的运行时本质以及它如何与 Python 的动态类型特性协同工作。一、-是什么函数签名中的返回类型注解在 Python 中-位于函数定义的参数列表与冒号之间用于声明函数的返回类型。它是 PEP 484 引入的函数注解function annotations体系的一部分与参数注解param: type相对应统一被称为返回类型注解def 函数名(参数: 参数类型, ...) - 返回类型: ...materials 仓库中最基础的示例 simple_type_hint_example.py 完整展示了这一语法def get_number_of_titles(titles: list[str]) - int: return len(titles) games [Dragon Quest, Final Fantasy, Age of Empires] print(Number of titles:, get_number_of_titles(games))这段代码传达了两条信息titles: list[str]声明参数是字符串组成的列表- int声明函数返回一个整数此处即len(titles)的结果。直接运行该脚本会输出Number of titles: 3。关于注解需要记住三个要点注解是可选的函数可以完全不写-和参数注解代码仍然合法可运行注解不影响运行时行为- int不会真的把返回值转换成整数也不会阻止函数返回其他类型。按 PEP 484 的约定注解只是作为元数据存放在函数的__annotations__属性中供人阅读和静态工具分析注解服务于说明而非约束它的主要受众是开发者、IDE 以及静态类型检查工具。二、常见返回类型注解int、str、float返回int如第一节所示- int表示返回整数典型的如len()、max()等运算结果。返回strstr_return_type_hint_example.py 演示了返回字符串的写法import random def get_game_recommendation(titles: list[str]) - str: return random.choice(titles) games [Dragon Quest, Final Fantasy, Age of Empires] print(Random recommendation:, get_game_recommendation(games))函数从游戏名列表中随机抽取一个元素返回返回值是字符串因此声明为- str。返回float浮点数返回类型在类方法一节见第六节中的Game.get_price()出现它返回游戏的price属性声明为- float。三、无返回值的函数- None不是所有函数都会返回有意义的值。只负责打印、写日志或修改外部状态的函数按 Python 约定应当返回None省略return语句时函数隐式返回None。此时用- None明确告知调用者不要依赖此函数的返回值。none_return_type_hint_example.py 是典型示范def find_keyword_in_titles(titles: list[str], keyword: str) - None: print(Titles that contain the keyword:, keyword) for game_title in titles: if keyword in game_title: print(game_title) games [Dragon Quest, Final Fantasy, Age of Empires] find_keyword_in_titles(games, es)函数内部只做打印没有return语句因此返回类型注解为None。运行后会在终端列出所有包含es的游戏标题此处为Dragon Quest。- None是 Python 代码中最常见的返回注解之一它让阅读者一眼就知道该函数是过程式调用其结果不可用于进一步计算。四、核心机制注解是建议不是强制这是理解-最关键的一点而目录中的 mismatched_return_type_example.py 正是为此设计的教学示例def get_number_of_titles(titles: list[str]) - str: return len(titles) games [Dragon Quest, Final Fantasy, Age of Empires] print(Number of titles:, get_number_of_titles(games))注意看函数注解声明返回str但len(titles)实际返回的是整数3——注解与真实返回值故意不一致。直接运行这段代码程序依然正常输出Number of titles: 3Python 解释器不会抛错也不会做任何类型检查。这个文件揭示的结论是返回类型注解本质上只是一份说明书Python 运行时完全忽略它。真正会计较类型不符的是 mypy、Pyright 等静态类型检查工具——从示例文件的写法可以推断如果对这段代码运行类型检查工具会报告函数声明返回 str 却返回了 int之类的类型错误。这也正是类型注解的实用价值所在让错误在开发阶段而不是运行阶段就被发现。五、复杂容器类型dict[str, int]等返回类型注解同样适用于复合容器类型。- dict[str, int]表示返回键为字符串、值为整数的字典。dictionary_return_type_example.py 结合了参数注解、返回注解与字典推导式def get_highest_stock_games(game_stock: dict[str, int]) - dict[str, int]: max_quantity max(game_stock.values()) return { game: quantity for game, quantity in game_stock.items() if quantity max_quantity } game_stock {Dragon Quest: 5, Final Fantasy: 1, Age of Empires: 5} print(Games with the highest stock:, get_highest_stock_games(game_stock))参数game_stock: dict[str, int]键是游戏名str值是库存数量int返回- dict[str, int]函数筛选出库存等于最大值的游戏用字典推导式构造新字典返回类型结构与输入一致运行输出Games with the highest stock: {Dragon Quest: 5, Age of Empires: 5}。需要特别提醒的是运行前提list[str]、dict[str, int]这类**内置泛型语法自 Python 3.9 起PEP 585**才可直接使用。本目录所有示例都采用这种写法因此运行它们需要 Python 3.9 及以上版本在更早的版本中需要改用typing.List[str]、typing.Dict[str, int]或通过from __future__ import annotations延迟解析注解。六、类方法中的返回类型注解-同样用于类的方法定义game_class_example.py 给出了一个完整的Game类示范class Game: def __init__(self, name: str, genre: str, price: float) - None: self.name name self.genre genre self.price price def get_name(self) - str: return self.name def get_genre(self) - str: return self.genre def get_price(self) - float: return self.price三个值得注意的点__init__的- None构造器按约定不返回值隐式返回None因此注解为None同时它的三个参数分别注解为name: str、genre: str、price: floatgetter 方法的返回注解get_name()与get_genre()返回字符串注解- strget_price()返回浮点数注解- float与__init__中存入的属性类型一一对应这个类展示的是一种常见模式用参数注解约束存入什么类型用返回注解声明取出什么类型从而在类内部形成完整的类型契约。七、为什么需要-Python 的动态类型与代码可读性要理解返回类型注解存在的意义需要回到 Python 的语言特性。dynamic_variable_example.py 用一个精炼的例子点明了这一点my_number 32 print(f{my_number }) my_number 32 print(f{my_number })运行输出为my_number 32 my_number 32同一个变量my_number先绑定整数32随后又绑定字符串32——Python 是动态类型语言变量本身没有固定类型类型只存在于对象上。这意味着如果不加任何说明调用方根本无法从代码看出get_number_of_titles到底返回整数、字符串还是别的什么上一节的错误示例正是在演示这种歧义。返回类型注解正是对这类问题的回应它带来四重收益自文档化- int让函数签名自带返回什么的信息减少注释负担IDE 支持编辑器可以据此提供准确的自动补全与类型提示静态检查mypy、Pyright 等工具可在不运行代码的前提下提前发现类型错误可验证性类型注解与__annotations__元数据可以被测试框架和文档工具读取。顺带一提该示例同时展示了 Python 3.8 引入的 f-string 调试语法f{变量 }它会自动打印变量名 值格式的输出非常适合在动态类型讨论中直观展示变量的实际类型。八、示例文件总览本目录 7 个示例文件与本文各节对应关系如下均可直接通过python 文件名.py运行需 Python 3.9文件仓库根目录相对路径核心演示内容对应章节simple_type_hint_example.py- int基础返回注解与list[str]参数注解第一节str_return_type_hint_example.py- str返回字符串注解第二节none_return_type_hint_example.py- None无返回值函数注解第三节mismatched_return_type_example.py声明- str实际返回int验证注解不参与运行时校验第四节dictionary_return_type_example.pydict[str, int]容器类型注解与字典推导式第五节game_class_example.py类方法与__init__的返回类型注解第六节dynamic_variable_example.py用 f-string 调试语法展示动态类型解释注解的动机第七节结语回到最初的问题Python 函数定义中的-到底是什么意思答案可以浓缩为一句话——它是 PEP 484 定义的返回类型注解声明函数返回值的类型仅为开发者、IDE 与静态检查工具提供信息Python 运行时不会据此做任何校验。materials 仓库的示例代码从基础类型int/str/float、无返回值None、容器类型dict[str, int]、故意写错的对照示例到类方法与动态类型演示完整覆盖了这一语法点的全部应用场景。把这份理解用到日常编码中你的函数签名将更具可读性也更容易被工具链和团队成员准确理解。赞分享示例工程教程【免费下载链接】materialsBonus materials, exercises, and example projects for our Python tutorials项目地址https://gitcode.com/gh_mirrors/ma/materials点击查看免费下载相关推荐spaCy 自然语言处理实战materials 仓库示例代码深度解析spaCy 自然语言处理实战materials 仓库示例代码深度解析 本文围绕开源仓库 materials 中 spacy 目录下的配套文档与示例代码系统讲示例工程教程modern-js-cheatsheet箭头函数详解从this绑定到隐式返回modern js cheatsheet箭头函数详解从this绑定到隐式返回 箭头函数是ES6引入的现代JavaScript重要特性彻底改变了函数声明和使用Python 表达式与语句的区别materials 仓库实战示例深度解析Python 表达式与语句的区别materials 仓库实战示例深度解析 表达式expression有值、可求值语句statement执行动作、产生示例工程教程上一篇2025生产力革命70亿参数Aquila-7B本地API服务部署全攻略附压测报告与优化方案下一篇OpenCore Legacy Patcher 快速上手老款 Intel Mac 装上最新 macOS创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考