python文件头注释及添加文件头模版

最新推荐文章于 2024-09-03 00:15:00 发布

洛阳山

最新推荐文章于 2024-09-03 00:15:00 发布

阅读量7.9k

点赞数 3

分类专栏： python 文章标签： python

本文链接：https://blog.csdn.net/u012949658/article/details/104681351

版权

python 专栏收录该内容

32 篇文章 8 订阅

订阅专栏

一、python文件头注释

主要是以下两行：

#!/usr/bin/env python
# -*-coding:utf-8 -*-

第一行是选定编译器的版本，一般我们都通过以下方式运行python代码：

python 1003.py

有了第一句之后，python文件就可以和shell脚本一样，直接执行：

$ chmod +x 1003.py
$ ./1003.py
hello world

如果你是通过python3 1003.py运行代码，这一句就得改成#!/usr/bin/env python3。

第二句告诉python解释器，这个文件是以UTF-8方式编码存储的，主要是为了避免代码中出现非ASCII字符（中文和日文）时，程序报错。如下：

$ cat 1003.py
#!/usr/bin/env python
print("你好")
$ ./1003.py 
  File "./1003.py", line 2
SyntaxError: Non-ASCII character '\xe4' in file ./1003.py on line 2, but no encoding declared; see http://python.org/dev/peps/pep-0263/ for details

#指定编码格式后，代码正常运行
$ cat 1003.py
#!/usr/bin/env python
# -*-coding:utf-8 -*-
print("你好")
$ ./1003.py 
你好

二、vscode添加python头模版

既然如此有用，能不能每次写python代码的时候自动添加呢？
因为我是用vscode写python代码，主要讲下vscode如何实现。

1、python头文件设置

在这里插入图片描述
之后选择python后会打开python.json，添加以下内容即可：

"HEADER":{
    "prefix": "header",
    "body": [
    "#!/usr/bin/env python",
    "# -*-coding:utf-8 -*-", 
    "'''",
    "@File    :   $TM_FILENAME",
    "@Time    :   $CURRENT_YEAR/$CURRENT_MONTH/$CURRENT_DATE $CURRENT_HOUR:$CURRENT_MINUTE:$CURRENT_SECOND",
    "@Author  :   Schiller Xu ",
    "@Version :   1.0",
    "@Contact :   schillerxu@qq.com",
    "@License :   (C)Copyright 2020-2021, SchillerXu",
    "@Desc    :   None",
    
    "'''",
    "$0"
],
}