VsCode 添加文件頭部注釋和函數(shù)注釋[koroFileHeader]

一個(gè)讀取用戶自定義模板夷蚊,通過(guò)快捷鍵添加文件頭部注釋、在光標(biāo)處添加函數(shù)注釋的VsCode插件

簡(jiǎn)介

  1. 文件頭部添加注釋:

    • 在文件開(kāi)頭添加注釋议经,記錄文件信息
    • 支持用戶高度自定義注釋選項(xiàng)
    • 保存文件的時(shí)候,自動(dòng)更新最后的編輯時(shí)間和編輯人
    • 快捷鍵:windowctrl+alt+i,macctrl+cmd+i
  2. 在光標(biāo)處添加函數(shù)注釋:

    • 在光標(biāo)處自動(dòng)生成一個(gè)注釋模板,下方有栗子
    • 支持用戶高度自定義注釋選項(xiàng)
    • 快捷鍵:windowctrl+alt+t,macctrl+cmd+t
    • 快捷鍵不可用很可能是被占用了,參考這里
  3. 支持不同語(yǔ)言的注釋格式掘宪,如下。

支持注釋格式:

  • /**/形式:Javascript/Java/go/C++/C

  • '''形式:python

  • ``形式:html

  • '形式: vba

安裝

在 Vscode 擴(kuò)展商店中搜索koroFileHeader,點(diǎn)擊安裝即可攘烛。

使用

  1. 文件頭部注釋:

    在當(dāng)前編輯文件中使用快捷鍵:windowctrl+alt+t/macctrl+cmd+t,即可生成文件頭部注釋魏滚。

  2. 函數(shù)注釋:

    1. 將光標(biāo)放在函數(shù)行或者將光標(biāo)放在函數(shù)上方的空白行
    2. 使用快捷鍵windowctrl+alt+t,macctrl+cmd+t,即可生成函數(shù)注釋坟漱。
    3. 事實(shí)上鼠次,函數(shù)注釋在文件的任意位置都可生成,這里需要自己控制芋齿。

注釋模板的設(shè)置

  • 默認(rèn)配置:

    在用戶首選項(xiàng)中搜索fileheader须眷,默認(rèn)配置為:

      "fileheader.customMade": {} // 頭部注釋
      "fileheader.cursorMode": {} // 函數(shù)注釋 
    復(fù)制代碼
    

    用戶未設(shè)置的情況下,頭部注釋和函數(shù)注釋模板為:

    image

    <figcaption style="display: block; text-align: center; font-size: 1rem; line-height: 1.6; color: rgb(144, 144, 144); margin-top: 2px;"></figcaption>

  • 自定義模板:

    1. 在用戶設(shè)置中沟突,搜索fileheader

    2. 復(fù)制默認(rèn)配置+修改配置,重啟生效

      [圖片上傳失敗...(image-9a3f56-1586483121967)]

      <figcaption style="display: block; text-align: center; font-size: 1rem; line-height: 1.6; color: rgb(144, 144, 144); margin-top: 2px;"></figcaption>

    如上設(shè)置花颗,生成注釋:

     // 文件頭部注釋
     /*
      * @Description: 
      * @version: 
      * @Company: BAT
      * @Author: OBKoro1
      * @Date: 2018-10-15 20:59:57
      * @LastEditors: OBKoro1
      * @LastEditTime: 2018-10-15 20:59:57
      */
     // 函數(shù)注釋
     /**
      * @name: 
      * @test: test font
      * @msg: 
      * @param {type} 
      * @return: 
      */
    復(fù)制代碼
    

自動(dòng)更新最后編輯時(shí)間、編輯人:

要開(kāi)啟這個(gè)功能惠拭,需要在首選項(xiàng)設(shè)置中填寫對(duì)應(yīng)的屬性:

  "fileheader.customMade": {
    "Date": "Do not edit", // 文件創(chuàng)建時(shí)間(不變)
    "LastEditors": "OBKoro1", // 文件最后編輯者
    "LastEditTime": "Do not edit" // 文件最后編輯時(shí)間
  }
  // 不填寫對(duì)應(yīng)屬性即關(guān)閉對(duì)應(yīng)功能
復(fù)制代碼

自動(dòng)更新編輯時(shí)間

示例:

image
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末扩劝,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子职辅,更是在濱河造成了極大的恐慌棒呛,老刑警劉巖,帶你破解...
    沈念sama閱讀 218,640評(píng)論 6 507
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件域携,死亡現(xiàn)場(chǎng)離奇詭異簇秒,居然都是意外死亡,警方通過(guò)查閱死者的電腦和手機(jī)秀鞭,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,254評(píng)論 3 395
  • 文/潘曉璐 我一進(jìn)店門趋观,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)扛禽,“玉大人,你說(shuō)我怎么就攤上這事皱坛”嗦” “怎么了?”我有些...
    開(kāi)封第一講書人閱讀 165,011評(píng)論 0 355
  • 文/不壞的土叔 我叫張陵剩辟,是天一觀的道長(zhǎng)掐场。 經(jīng)常有香客問(wèn)我,道長(zhǎng)贩猎,這世上最難降的妖魔是什么熊户? 我笑而不...
    開(kāi)封第一講書人閱讀 58,755評(píng)論 1 294
  • 正文 為了忘掉前任,我火速辦了婚禮吭服,結(jié)果婚禮上嚷堡,老公的妹妹穿的比我還像新娘。我一直安慰自己噪馏,他們只是感情好麦到,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,774評(píng)論 6 392
  • 文/花漫 我一把揭開(kāi)白布。 她就那樣靜靜地躺著欠肾,像睡著了一般瓶颠。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上刺桃,一...
    開(kāi)封第一講書人閱讀 51,610評(píng)論 1 305
  • 那天粹淋,我揣著相機(jī)與錄音,去河邊找鬼瑟慈。 笑死桃移,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的葛碧。 我是一名探鬼主播借杰,決...
    沈念sama閱讀 40,352評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼进泼!你這毒婦竟也來(lái)了蔗衡?” 一聲冷哼從身側(cè)響起,我...
    開(kāi)封第一講書人閱讀 39,257評(píng)論 0 276
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤乳绕,失蹤者是張志新(化名)和其女友劉穎绞惦,沒(méi)想到半個(gè)月后,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體洋措,經(jīng)...
    沈念sama閱讀 45,717評(píng)論 1 315
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡济蝉,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,894評(píng)論 3 336
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片王滤。...
    茶點(diǎn)故事閱讀 40,021評(píng)論 1 350
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡贺嫂,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出淑仆,到底是詐尸還是另有隱情涝婉,我是刑警寧澤哥力,帶...
    沈念sama閱讀 35,735評(píng)論 5 346
  • 正文 年R本政府宣布蔗怠,位于F島的核電站,受9級(jí)特大地震影響吩跋,放射性物質(zhì)發(fā)生泄漏寞射。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,354評(píng)論 3 330
  • 文/蒙蒙 一锌钮、第九天 我趴在偏房一處隱蔽的房頂上張望桥温。 院中可真熱鬧,春花似錦梁丘、人聲如沸侵浸。這莊子的主人今日做“春日...
    開(kāi)封第一講書人閱讀 31,936評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)掏觉。三九已至,卻和暖如春值漫,著一層夾襖步出監(jiān)牢的瞬間澳腹,已是汗流浹背。 一陣腳步聲響...
    開(kāi)封第一講書人閱讀 33,054評(píng)論 1 270
  • 我被黑心中介騙來(lái)泰國(guó)打工杨何, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留酱塔,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 48,224評(píng)論 3 371
  • 正文 我出身青樓危虱,卻偏偏與公主長(zhǎng)得像羊娃,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子埃跷,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,974評(píng)論 2 355

推薦閱讀更多精彩內(nèi)容