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

2024-01-10 12:30:06

随机记录

目录

1. 背景介绍

2.?"Docstring Generator"扩展

2.1 安装

2.2 设置注释信息

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 文件参数注释自动生成、头文件注释自动添加功能

文章来源:https://blog.csdn.net/weixin_57632548/article/details/135495967
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。