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

随机记录

目录

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