Python 技巧篇-开头注释怎么写最好,开头注释需要包含什么,开头注释的重要性

开头注释除了必要的信息外,一些简单的介绍也是尤为重要呢,比如作者、创建日期、更新日期、里面代码大体是实现什么功能的简要介绍。这些介绍不但是规范,更是一种认真工作态度的体现。

下面给大家展示一下我的开头注释是怎么写的。

#!/user/bin/env python
# -*- coding:utf-8 -*-
# 作者:小蓝枣
# 创建:2019-03-01
# 更新:2019-03-15
# 用意:用于剪切板内容编辑

#!user/bin/env python
这行代码在unix类系统里才有用,linux系统就属于unix类系统。
这是告诉系统要运行这个文件要用什么运行。
windows系统是根据扩展名.py来关联的,所以只要是.py结尾,直接就会用python来运行;
以前还有这么写的,直接指明python的绝对位置:#!user/bin/python
因为python有可能不在bin下面,env python是直接找到python的安装位置,更实用

# -*- coding:utf-8 -*-
python2系列默认不支持中文,只有使用utf-8等支持中文的编码,才可以使用中文。
python3系列默认就支持中文了,所以无论是什么编码也没问题了。

我觉得一段好代码,应该有更好的兼容性,我们写了这样的开头,直接就可以在linux下和python2下运行,这些还是很主流的,而且对我们的windows和python3一点影响也没有,多么两全其美!

一个好的程序员,当然要有一段好的开头注释,当然最好还要有自己的风格,让人一看就知道这是你写的,这就是你的门面,你的记号。

喜欢的点个赞❤吧!

posted on 2019-03-17 18:51  小蓝枣  阅读(32)  评论(0编辑  收藏  举报