Python新手关于函数注释的问题
初学 python3 ， IDE 是 PyCharm ， PHP IDE 是 phpStorm
在 PHP 中，函数或方法可以加类似这样的注释（ PHPDoc ）
/**
* 连接到驱动
* [@param](/user/param) string $host
* [@param](/user/param) string $port
* [@return](/user/return) mixed
*/
IDE 可以识别并给出相应的提示、补全等，非常方便
但是在 python 里没有发现有相应的规范
搜了一下，都是些#单行、三引号多行之类，没有发现有类似 JavaDoc 、 PHPDoc 之类的注释规范，这写起代码来就很蛋疼啊
是 python 本身的问题吗？还是我没找到？
Python新手关于函数注释的问题
18 回复
函数注释（Function Annotations）是Python 3引入的特性，主要用来给函数参数和返回值添加元数据，语法是在参数名或->后加冒号和表达式。比如：
def greet(name: str, times: int) -> str:
return (name + " ") * times
这里的str和int就是注释，说明name应该是字符串，times应该是整数，返回值是字符串。但要注意，这些注释只是注解，Python解释器不会做任何类型检查，它只是把注释存到函数的__annotations__属性里：
print(greet.__annotations__) # 输出：{'name': <class 'str'>, 'times': <class 'int'>, 'return': <class 'str'>}
如果你想做静态类型检查，需要用typing模块配合mypy这类工具。对于新手，我建议先写清楚注释，等熟悉了再用typing。
总结：函数注释是给参数和返回值加说明的元数据，但不影响运行。
#11 再请问下：我发现 import 好像并不是非要写在文件头的。那是不是当我要用到的时候再 import 这样性能会更好些呢？
#13
#14
#15
感谢，已按照 PyCharm 的帮助文档用上三引号了
