vscode 创建文件自动添加注释信息

芝麻馅汤圆儿2024-01-11 18:57

随机记录

[1. 背景介绍](#1. 背景介绍)

[2. "Docstring Generator"扩展](#2. "Docstring Generator"扩展)

[2.1 安装](#2.1 安装)

[2.2 设置注释信息](#2.2 设置注释信息)

[3. 自动配置py 文件头注释](#3. 自动配置py 文件头注释)

1. 背景介绍

在VS Code中，您可以使用扩展来为新创建的Python文件自动添加头部注释信息。有几个常用的扩展可以实现此功能，如

"Docstring Generator"
"Docstring"
"autoDecstring"

2. "Docstring Generator"扩展

2.1 安装

步骤：
1. 在VS Code中打开扩展面板（快捷键为Ctrl+Shift+X）
2. 搜索并安装"Docstring Generator"扩展

2.2 设置注释信息

步骤：
1. 安装完成后，打开一个新创建的Python文件
2. 在文件的顶部行，键入3个引号 """ 并按下回车键，自动生成函数参数注释

3. 自动创建了一个多行注释块，您可以在其中填写作者、文件名、函数名等信息

3. 自动配置py 文件头注释

步骤：
1. 依次单击菜单栏 "File"---"Preferences"---"User Snippets" --> 'python' 选择python后会生成python.json文件，将该文件内容替换为以下内容：

	"HEADER": {
		"prefix": "header",
		"body": [
		  "#!/usr/bin/env python",
		  "# -*- encoding: utf-8 -*-",
		  "'''",
		  "@文件    :$TM_FILENAME",
		  "@说明    :",
		  "@时间    :$CURRENT_YEAR/$CURRENT_MONTH/$CURRENT_DATE $CURRENT_HOUR:$CURRENT_MINUTE:$CURRENT_SECOND",
		  "@作者    :magx",
		  "@版本    :1.0",
		  "'''",
		  "",
		  "$0"
		],
	  }

2. 保存修改即可。

新建一个python文件，然后在头部敲入header即可自动弹出下面的注释

至此，已完成vscode 上py 文件参数注释自动生成、头文件注释自动添加功能