python函数后写注释的简单介绍

python的注释怎么加？

python中的注释有多种，有单行注释，多行注释，批量注释，中文注释也是常用的。

常宁ssl适用于网站、小程序/APP、API接口等需要进行数据传输应用场景，ssl证书未来市场广阔！成为成都创新互联公司的ssl证书销售渠道，可以享受市场价格4-6折优惠！如果有意向欢迎电话联系或者加微信：13518219792（备注：SSL证书合作）期待与您的合作！

一、python单行注释符号(#)：井号(#)常被用作单行注释符号，在代码中使用#时，它右边的任何数据都会被忽略，当做是注释。print 1 #输出1，#号右边的内容在执行的时候是不会被输出的。

二、批量、多行注释符号：在python中也会有注释有很多行的时候，这种情况下就需要批量多行注释符了。多行注释是用三引号''' '''包含的。

python正则表达式的注释方法：学过正则都知道，那简直是天书，为了提高正则的可读性，正则表达式中提供了X(VERBOSE): 详细模式。这个模式下正则表达式可以是多行，忽略空白字符，并可以加入注释。

Python：

是完全面向对象的语言。函数、模块、数字、字符串都是对象。并且完全支持继承、重载、派生、多继承，有益于增强源代码的复用性。Python支持重载运算符和动态类型。

相对于Lisp这种传统的函数式编程语言，Python对函数式设计只提供了有限的支持。有两个标准库(functools, itertools)提供了Haskell和Standard ML中久经考验的函数式程序设计工具。

Python如何进行中文注释

#在Python中显示中文注释和输出中文

a ="中文"

print a

d:\Python27\python.exe "D:\test\中文.py"

Process started

File "D:\test\中文.py", line 1

SyntaxError: Non-ASCII character '\xe5' in file D:\test\中文.py on line 1, but no encoding

declared; see for details

Process finished. (Exit code 1)

#-*- coding:utf-8 _*-

#在Python中显示中文注释和输出中文

a ="中文"

print a

d:\Python27\python.exe "D:\test\中文.py"

Process started

Process finished. (Exit code 0)

#-*- coding:utf-8 _*-

#在Python中显示中文注释和输出中文

a ="中文"

print a.decode('utf-8').encode('cp936')

d:\Python27\python.exe "D:\test\中文.py"

Process started

中文

Process finished. (Exit code 0)

扩展资料

python源代码必须完全由ASCII集合组成，如果直接在python中添加中文注释的时候，python执行时会引发异常，告知非ASCII字符语法错误。

类似：SyntaxError: Non-ASCII character.....................but no encoding declared;

解决方法就是告知python使用的编码方式，告知方法是在源文件的初始部分，而且必须放在第一行，否则不起作用！

例如：

#coding=utf-8

或

#coding=gbk

表示文件的编码

参考资料：百度百科 - Python

Python教程：单行多行注释

工具/材料

python

01

在python中使用#号表示单行注释

02

使用""" """或''' '''做为多行注释

03

单行注释和多行注释不宜过多,不是每行代表都要注释,最好用来解释函数的操作

04

以下是一些错误使用注释的方式,一些能直接看到结果的代码最好不要多写注释

特别提示

关键代码,复杂代码使用注释

Python中如何添加注释

# 单行注释

'''多行注释

多行注释

多行注释

'''

Python 语句和注释

我们将在本节中介绍 Python 语句，缩进以及注释，在本节的最后一部分，还会介绍作为一种特殊类型的 Python 注释 Docstring 。

Python 语句是给解释器执行的指令，一条 Python 语句包含类似于如下的表达式，

你可以将 Python 语句堪称解释器解释表达式并将其结果存储在变量中的指令。类似于 for , while , print 之类的语句具有特殊的含义，我们将在在后面的章节中讨论。

当你在一句语句结束时按回车键后，该 Python 语句被终止，我们可称之为单行语句。Python 中的多行语句可以通过使用连续字符 来创建，它将 Python 语句扩展为多行语句。

比如下面的例子，

这可以被称作明确的多行接续。

你还可以使用括号 () ，方括号 [] 或大括号 {} 来进行隐式的多行接续。

例如，你可以使用括号来连接多行语句，

Python 语句块，例如函数，循环或类的主体，以缩进来开头。对于语句块内的每个语句，应该保持相同的缩进。当缩进不一致时，你将得到什么什么 IndentationError 。

一般来说，在

Python 代码样式指南

中建议使用 4 个缩进空格。举例如下，

我们用缩进来增加程序的可读性，比如在下面的程序中，我们用两种方式来完成同一个功能，

你可以在这里看到第一个例子比第二个例子有更好的可读性。

注释用于描述程序的目的或工作工程，注释是在 Python 解释过程中被忽略的行为，它们不会干扰程序的流程。

如果你正在编写数百行代码，肯定需要添加注释，因为其他人在阅读你的代码的时候，没有足够的时间阅读每一行来理解代码的工作。程序的注释增加了可读性，并解释了代码的工作原理。

Python 注释以井号 # 开始

Using hash symbol in each line can define a multi-line comment. But there is another way to add a multi-line comment in Python, that is using triple quotation marks. You can use either ''' or """ .

三重引号 ''' 通常可以用来定义多行文档注释 Docstring ，你也可以用它来作为另外一种在 Python 中添加多行注释的方法。

Docstring 是文档字符串，它通常是 Python 函数，类，模块等的第一条语句。函数，方法和类的描述和注释位于文档字符串（文档字符串）内。

举例如下，

一目了然， Docstring 介绍了函数的功能。

Python函数注解使用有哪些注意事项呢？

函数注解是关于用户自定义的函数的完全可选的、随意的元数据信息。

1.无论 Python 本身或者标准库中都没有使用函数注解；本节只是描述了语法。第三方的项目是自由地为文档，类型检查，以及其它用途选择函数注解。

2.注解是以字典形式存储在函数的 __annotations__ 属性中，对函数的其它部分没有任何影响。参数注解（Parameter annotations）是定义在参数名称的冒号后面，紧随着一个用来表示注解的值得表达式。返回注释（Return annotations）是定义在一个 - 后面，紧随着一个表达式，在冒号与 - 之间。下面的示例包含一个位置参数，一个关键字参数，和没有意义的返回值注释:

def f(ham: 42, eggs: int = 'spam') - "Nothing to see here":

... print("Annotations:", f.__annotations__)

... print("Arguments:", ham, eggs)

...

f('wonderful')

Annotations: {'eggs':

, 'return': 'Nothing to see here', 'ham': 42}

Arguments: wonderful spam