1.简介

  1. VSCode插件: 用于一键生成文件头部注释并主动更新最终修正人和修正时刻、函数注释主动生成和参数提取。
  2. 插件可以协助用户养成良好的编码习惯，规范整个团队风格。

主要功能

  1. 主动生成文件头部注释，主动更新最终修正人、最终修正时刻等。
  2. 一键生成函数注释，支撑函数参数主动提取并列到注释中。
  3. 支撑增加佛祖保佑永无bug、神兽护体、甩葱少女等好玩有趣的图画注释。
  4. 装备十分灵活便利，各种细节都能装备，可以量身打造合适你的注释。
  5. 支撑一切主流语言, 装备文档十分详细，完全。

2.安装

在 Vscode 扩展商铺中搜索koroFileHeader, 点击安装。

3.运用

默许快捷键

文件头部注释快捷键

window：ctrl+win+i,mac：ctrl+cmd+i,linux:ctrl+meta+i,Ubuntu:ctrl+super+i

函数注释快捷键

window：ctrl+win+t,mac：ctrl+cmd+t,linux:ctrl+meta+t,Ubuntu:ctrl+super+t

函数注释光标移动到下一行行尾，快速增加函数参数描述

window:win+y, mac:cmd+y, linux:meta+y

图画注释快捷键

  • 随机生成：window：ctrl+alt+j, mac：ctrl+cmd+j
  • 精确挑选：快捷键Ctrl + P,输入> codeDesign,挑选想要的图画注释

自定义快捷键

经常出现快捷键失灵的状况，这是由于VSCode快捷键抵触导致。这时需求我们自定义VSCode快捷键。

点击VSCode左下角管理图标–>点击键盘快捷方式，或直接运用快捷键Ctrl + K Ctrl + S打开键盘快捷方式修正窗口。

注意：修正快捷键前先检查想要运用的快捷键是否被占用。

一共四个快捷键需求设置，别离搜索

  1. 头部注释：extension.fileheader
  2. 函数注释：extension.cursorTip
  3. 光标移动：koroFileheader.table
  4. 随机图画：extension.codeDesign

4.插件自定义装备

"fileheader.customMade": {
	//此为头部注释
	"Description": "",
	"Version": "V1.0.0",
	"Author":"git config user.name && git config user.email", 
	"Date": "Do not edit",
	"LastEditors": "git config user.name && git config user.email",
	"LastEditTime": "Do not edit",
	"FilePath": "only file name", 
        // 版权声明 保留一切权力 主动替换年份
	"custom_string_obkoro1_copyright": "Copyright ${now_year} Marvin, All Rights Reserved. ",
	"custom_string_obkoro1_date": "Do not edit", // 版权时刻
},
"fileheader.cursorMode": {
	//此为函数注释
	"description": "",
	"param": "",
	"return": "",
	"Date": "Do not edit",
	"Author": "git config user.name && git config user.email",
	"LastEditors": "git config user.name && git config user.email",
	"LastEditTime": "Do not edit"
},
"fileheader.configObj": {
	"createFileTime": false,
	"language": {
		"languagetest": {
			"head": "/$$",
			"middle": " $ @",
			"end": " $/",
			"functionSymbol": {
				"head": "/** ",
				"middle": " * @",
				"end": " */"
			},
			"functionParams": "js"
		}
	},
	"autoAdd": false, // 主动增加头部注释是否敞开，默许为true
	"autoAddLine": 100,
	"autoAlready": true,
	"annotationStr": {
		"head": "/*",
		"middle": " * @",
		"end": " */",
		"use": false
	},
	"headInsertLine": {
		"php": 2,
		"sh": 2
	},
	"beforeAnnotation": {
		"文件后缀": "该文件后缀的头部注释之前增加某些内容"
	},
	"afterAnnotation": {
		"文件后缀": "该文件后缀的头部注释之后增加某些内容"
	},
	"specialOptions": {
		"特殊字段": "自定义比如LastEditTime/LastEditors"
	},
	"switch": {
		"newlineAddAnnotation": true
	},
	"supportAutoLanguage": [],
	"prohibitAutoAdd": ["json", "md"], // 禁止主动增加头部注释的文件类型
	"folderBlacklist": ["node_modules", "文件夹禁止主动增加头部注释"],
	"prohibitItemAutoAdd": ["项目的全称, 整个项目禁止主动增加头部注释, 可以运用快捷键增加"],
	"moveCursor": true,
	"dateFormat": "YYYY-MM-DD HH:mm:ss",
	"atSymbol": ["@", "@"],
	"atSymbolObj": {
		"文件后缀": ["头部注释@符号", "函数注释@符号"]
	},
	"colon": [": ", ": "],
	"colonObj": {
		"文件后缀": ["头部注释冒号", "函数注释冒号"]
	},
	"filePathColon": "路径分隔符替换",
	"showErrorMessage": false,
	"writeLog": false,
	"wideSame": true,
	"wideNum": 13, // 头部注释主动对齐的宽度
	"functionWideNum": 15, // 函数注释主动对齐宽度
	"CheckFileChange": true,
	"createHeader": true,
	"useWorker": false,
	"designAddHead": false,
	"headDesignName": "random", // 头部图画注释，默许随机
	"headDesign": false, // 默许封闭 敞开后,一切生成头部注释的场景都会生成图画注释
	"cursorModeInternalAll": {},
	"openFunctionParamsCheck": true,
	"functionParamsShape": ["{", "}"],
	"functionBlankSpaceAll": {},
	"functionTypeSymbol": " ", // 参数没有类型时的默许值
	"typeParamOrder": "type param",
	"customHasHeadEnd": {},
	"throttleTime": 60000,
	"functionParamAddStr": "",
},

其他详细装备可查阅官方GitHub

也可查阅C盘下的VSCode扩展源码。