python中文函数注释的简单介绍

python 的注释中不能用汉字的解决办法

开始学python，编的函数居然不能用汉字注释，网上查了一下，在文件的头2行加入

为安新等地区用户提供了全套网页设计制作服务，及安新网站建设行业解决方案。主营业务为成都网站建设、网站设计、安新网站设计，以传统方式定制建设网站，并提供域名空间备案等一条龙服务，秉承以专业、用心的态度为用户提供真诚的服务。我们深信只要达到每一位用户的要求，就会得到认可，从而选择与我们长期合作。这样，我们也可以走得更远！

# -- coding: utf-8 --

就可以了

如下面的函数，运行就不会报错了

# 计算面积的函数

def cal_area(  width , height ):

return width*height

OK！

python的注释

python中的注释一般分为单行注释、多行注释以及文档注释。

1、单行注释：在所需注释行前面加上英文#号或使用crtl+/快捷键进行操作。

2、多行注释：按住鼠标左键，选中所需注释的全部行，按住crtl+/快捷键。

3、文档注释（也可以理解为多行注释）：是三对英文的双引号或单引号。

Python如何进行中文注释

基于文本文档(Markdown) 设想好需要的基本需要的表、字段、类型；

使用 Rails Migration 随着功能的开发逐步创建表；

随着细节功能的开发、需求，逐步增加字段，删除字段，或者调整字段类型；

第一个 Release 的时候清理 Migrations 合并成一个;

随着后期的改动，逐步增加、修改、删除字段或表。

基本上我的所有项目都是这么搞的，这和项目是否复杂无关。

所以我前面为什么说思路需要转变。

python能添加注释么 怎么添加

概述

能添加注释，python注释分为两种，单行注释和多行注释

解析

单行注释：

井号(#)常被用作单行注释符号，在代码中使用#时，它右边的任何数据都会被忽略，当做是注释。

print 1 #输出1

#号右边的内容在执行的时候是不会被输出的。

格式：

# 单行注释

#code:

可以看到输出结构，被注释的内容都没有运行

#out:

批量、多行注释符号：

在python中也会有注释有很多行的时候，这种情况下就需要批量多行注释符了。多行注释是用三引号'''   '''包含的，多行注释就是被多行注释标识符所包裹的内容不会被运行

格式：

'''

多行注释

多行注释

'''

"""

多行注释

多行注释

"""

#code:

#out:

python中文注释方法:

在python编写代码的时候，避免不了会出现或是用到中文，这时候需要在文件开头加上中文注释。比如创建一个python list，在代码上面注释上它的用途，如果开头不声明保存编码的格式是什么，那么它会默认使用ASKII码保存文件，这时如果代码中有中文就会报错了，即使中文是包含在注释里面的。所以加上中文注释很重要。

#coding=utf-8

或者：

#coding=gbk

拓展内容

python

Python（英国发音：/ˈpaɪθən/ 美国发音：/ˈpaɪθɑːn/）, 是一种面向对象的解释型计算机程序设计语言，由荷兰人Guido van Rossum于1989年发明，第一个公开发行版发行于1991年。

Python是纯粹的自由软件， 源代码和解释器CPython遵循 GPL(GNU General Public License)协议。Python语法简洁清晰，特色之一是强制用空白符(white space)作为语句缩进。

Python具有丰富和强大的库。它常被昵称为胶水语言，能够把用其他语言制作的各种模块（尤其是C/C++）很轻松地联结在一起。常见的一种应用情形是，使用Python快速生成程序的原型（有时甚至是程序的最终界面），然后对其中有特别要求的部分，用更合适的语言改写，比如3D游戏中的图形渲染模块，性能要求特别高，就可以用C/C++重写，而后封装为Python可以调用的扩展类库。需要注意的是在您使用扩展类库时可能需要考虑平台问题，某些可能不提供跨平台的实现。

7月20日，IEEE发布2017年编程语言排行榜：Python高居首位  。

2018年3月，该语言作者在邮件列表上宣布 Python 2.7将于2020年1月1日终止支持。用户如果想要在这个日期之后继续得到与Python 2.7有关的支持，则需要付费给商业供应商。

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

python注释的方式为

注释，确保对模块、函数、方法和行内注释使用正确的风格。

python中的注释有单行注释和多行注释：

1、单行注释(行注释)

python中使用#表示单行注释。单行注释可以作为单独的一行放在被注释代码行之上，也可以放在语句或表达式之后。

比如：

# 这是一个注释

print("Hello, World!")

①当单行注释作为单独的一行放在被注释代码行之上时，为了保证代码的可读性，建议在#后面添加一个空格，再添加注释内容。

②当单行注释放在语句或者表达式之后时，同样为了保证代码的可读性，建议注释和语句之间至少要有两个空格。

2、多行注释(块注释)

当注释内容过多，导致一行无法显示时，就可以使用多行注释。多行注释用三个单引号'''或者三个双引号 """将注释括起来。

①单引号(''')

'''

这是多行注释，用三个单引号

这是多行注释，用三个单引号

这是多行注释，用三个单引号

'''

print("Hello, World!")

②双引号(""")

"""

这是多行注释，用三个双引号

这是多行注释，用三个双引号

这是多行注释，用三个双引号

"""

print("Hello, World!")

3、注意

①注释不是越多越好，对于一目了然的代码，不需要添加注释;

②对于复杂的操作，应该在操作开始前写上相应的注释;

③对于不是一目了然的代码，可以在代码之后添加注释;

④绝对不要描述代码，一般阅读代码的人都了解python的语法，只是不知道代码要干什么。