VSCode多行注釋插件KoroFileHeader如何使用

這篇文章主要講解了“VSCode多行注釋插件KoroFileHeader如何使用”，文中的講解內容簡單清晰，易于學習與理解，下面請大家跟著小編的思路慢慢深入，一起來研究和學習“VSCode多行注釋插件KoroFileHeader如何使用”吧！

1.簡介

• VSCode插件: 用于一鍵生成文件頭部注釋并自動更新最后編輯人和編輯時間、函數注釋自動生成和參數提取。

• 插件可以幫助用戶養成良好的編碼習慣，規范整個團隊風格。

主要功能

• 自動生成文件頭部注釋，自動更新最后編輯人、最后編輯時間等。

• 一鍵生成函數注釋，支持函數參數自動提取并列到注釋中。

• 支持添加佛祖保佑永無bug、神獸護體、甩蔥少女等好玩有趣的圖像注釋。

• 配置非常靈活方便，各種細節都能配置，可以量身打造適合你的注釋。

• 支持所有主流語言, 配置文檔非常詳細，齊全。

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打開鍵盤快捷方式修改窗口。

注意：修改快捷鍵前先查看想要使用的快捷鍵是否被占用。

一共四個快捷鍵需要設置，分別搜索

• 頭部注釋：extension.fileheader

• 函數注釋：extension.cursorTip

• 光標移動：koroFileheader.table

• 隨機圖案：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": "",
},

感謝各位的閱讀，以上就是“VSCode多行注釋插件KoroFileHeader如何使用”的內容了，經過本文的學習后，相信大家對VSCode多行注釋插件KoroFileHeader如何使用這一問題有了更深刻的體會，具體使用情況還需要大家實踐驗證。這里是億速云，小編將為大家推送更多相關知識點的文章，歡迎關注！