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一点影响也没有,多么两全其美!
一个好的程序员,当然要有一段好的开头注释,当然最好还要有自己的风格,让人一看就知道这是你写的,这就是你的门面,你的记号。
喜欢的点个赞❤吧!
各位好,我是csdn的小蓝枣,现在我的博客已经同步到博客园啦,欢迎大家关注哈!也欢迎大家关注我的公众号Py_JSQY!每天会更新有趣的科技文!哈哈!