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