好用的VSCode头部注释插件Fileheader Pro

作者:IronLu233 时间:2023-07-05 06:16:00 

动机

有时候需要在代码头部添加像这样的一段注释。这段注释包括了作者、代码版权许可等信息。每次重复添加都会让您觉得非常麻烦。作为开发者的您,时间是自然非常。那么这个插件,就是为这个场景而生,替你无感地默默做完这件事。如果您想要在代码头部添加一些类似这样的ASCII Art。它也能满足您的需求。

/*
* @Author: IronLu233
* @Date: 2021-03-10 12:00:00
* Copyright © 你的公司名字. All rights reserved.
*/
/*
#### ########   #######  ##    ## ##       ##     ##  #######   #######   #######  
##  ##     ## ##     ## ###   ## ##       ##     ## ##     ## ##     ## ##     ##
##  ##     ## ##     ## ####  ## ##       ##     ##        ##        ##        ##
##  ########  ##     ## ## ## ## ##       ##     ##  #######   #######   #######  
##  ##   ##   ##     ## ##  #### ##       ##     ## ##               ##        ##
##  ##    ##  ##     ## ##   ### ##       ##     ## ##        ##     ## ##     ##
#### ##     ##  #######  ##    ## ########  #######  #########  #######   #######  
* @author        IronLu233 <lrironsora@gmail.com>
* @date          2022-06-12 22:33:53
*/

这段代码来自这里

安装与使用

如何获得它

  • Fileheader Pro - Visual Studio Marketplace VSCode扩展市场,点击Install

让它默默添加头部注释

文件注释中的信息来自于您的版本控制工具,目前插件还只支持Git,再未来它将支持SVN,Mercurial等其它版本控制工具。 因此请您确保在有Git的项目中使用它。

安装后,默认的模板将能复合大部分的使用场景。

当你新建一个文件后,将会自动地为你添加Fileheader。因此大部分情况下您不需要下文中的手动添加

好用的VSCode头部注释插件Fileheader Pro

如您需要手动添加到已有代码,打开一个文件后,在您的命令面板里【您可以使用Ctrl(Mac下是Command) + Shift + P】,输入 Fileheader Pro: Add Fileheader并按下回车,就能见到文件注释恰如其分地加入到了您巧夺天工的代码头部。

好用的VSCode头部注释插件Fileheader Pro

保存时,您的文件头部注释需要更新时,Fileheader Pro将会自动为您更新。

好用的VSCode头部注释插件Fileheader Pro

自定义模板

尽管自带的模板能满足大部分场景。但自定义模板的强大与整活能力,也值得为它去专门配置。

好用的VSCode头部注释插件Fileheader Pro

别忘了将你的模板提交到git上,并且让与你一起开发的同学也安装Fileheader Pro

首先我们需要创建一个模板。在您VSCode的命令面板中,执行这样的命令: Fileheader Pro: Generate Custom Fileheader Template;

好用的VSCode头部注释插件Fileheader Pro

此时在项目的根目录下的.vscode/fileheader.template.js。 请修改类CustomLanguageProvider。特别是它的getTemplate方法。它的返回值,就决定了您的文件头部注释最后的模样。另外,languages将会决定,在那些语言的文件中它可以被使用。

请务必将所有返回的字符串使用tpl进行模板字符串函数的调用,否则可能会出现一些奇奇怪怪的问题

好用的VSCode头部注释插件Fileheader Pro

可以使用variable中的各个字段,对其进行加工处理,放入模板之中。 variables的字段有下列这些

字段含义
birthtime文件被创建的时间,如果它被版本控制系统所追踪那么会从版本控制系统中获取创建时间,否则将使用文件在磁盘中创建的时间
mtime文件被修改时间。获取逻辑同birthime,不建议使用mtime。因为当一个文件被多个人修改时,他们关于mtime的注释,会在代码合并时造成冲突!
authorName作者名字,会从版本控制工具历史中寻找,如果这个文件是新的,那么它将会使用userName
authorEmail作者的电子邮箱,回退机制同authorName
userName用户的名字。对于git来说,会通过git config user.name获取
userEmail用户的电子邮箱,对于git会通过git config user.email获取
companyName公司名称。没有公司的可以去工商局登记成立
projectName当前项目的名称,也就是就是VSCode所打开的文件夹的名称
filePath当前文件的路径
dirPath当前文件的目录路径
fileName当前文件的文件名

Fileheader Pro源代码本身就使用了自定义模板添加头部注释。

所以它也是一个例子

fileheader-pro/fileheader.template.js at main &middot; IronLu233/fileheader-pro (github.com)

配置项

FileheaderPro.disableFileds

对于默认的模板,其中的各个字段都可以通过它来禁用。禁用的字段将不会出现在注释之中。 您可以在VSCode的设置界面中,对其进行修改

默认值是['mtime']。不建议启用mtime。因为当一个文件被多个人修改时,他们关于mtime的注释,会在代码合并时造成冲突!

好用的VSCode头部注释插件Fileheader Pro

FileheaderPro.companyName

您需要在设置中,告诉插件公司的名字,因为无法从任何其它地方得到它!

FileheaderPro.currentUserName和FileheaderPro.currentUserEmail

这两个字段可以直接覆盖掉模板中的userNameuserEmail变量,也会间接影响authorNameauthorEmail(当文件并未被版本控制工具追踪的时候)

FileheaderPro.dateFormat

注释中的日期的格式。请参考:momentjs.com/docs/#/disp&hellip;

FileheaderPro.autoInsertOnCreateFile

是否启用创建文件时,自动添加文件头部注释。默认它是开启的

FileheaderPro.autoUpdateOnSave

是否保存时更新fileheader。默认启用。

Fileheader Pro内部只在需要的时候更新文件头部注释。

Q & A

它是怎么实现的?

使用了ES6的tagged template。

我们可以知道哪一些是固定的字符串,哪一些是用户所使用的变量。接下来请参考这个抽象类

fileheader-pro/FileheaderLanguageProvider.ts at main &middot; IronLu233/fileheader-pro (github.com)

没有我支持的语言

目前支持这些语言

  • Javascript

  • Typescript

  • Python

  • HTML

  • CSS

  • Vue

  • Java 请使用自定义模板,或者发起一个issue。当然,也欢迎提PR来为Fileheader Pro添砖加瓦

来源:https://juejin.cn/post/7117997347837067301

标签:VSCode,头部注释,Fileheader,插件
0
投稿

猜你喜欢

  • Git的撤销、修改和回退命令

    2022-12-05 14:10:12
  • 使用python自动追踪你的快递(物流推送邮箱)

    2022-06-14 11:42:04
  • 生成二维码方法汇总

    2024-04-27 15:23:32
  • 聊一聊Vue.js过渡效果

    2024-05-13 09:07:51
  • Python中类的初始化特殊方法

    2021-05-26 14:50:01
  • Python接口自动化判断元素原理解析

    2022-09-04 18:33:58
  • 基于python判断字符串括号是否闭合{}[]()

    2022-03-25 15:58:45
  • Oracle数据库安全策略分析(一)

    2010-07-31 12:57:00
  • python pprint模块中print()和pprint()两者的区别

    2023-10-18 07:34:18
  • django中使用原生sql语句的方法步骤

    2023-06-29 16:36:07
  • Vue2.0利用 v-model 实现组件props双向绑定的优美解决方案

    2024-05-02 17:09:28
  • php session应用实例 登录验证

    2023-11-14 13:49:43
  • mysql错误处理之ERROR 1665 (HY000)

    2024-01-21 12:16:54
  • OpenCV图像识别之姿态估计Pose Estimation学习

    2023-08-10 14:25:28
  • Linux下rpm方式安装mysql教程

    2024-01-21 07:40:53
  • Sql Server中常用的6个自定义函数分享

    2024-01-17 05:05:40
  • Flask SQLAlchemy一对一,一对多的使用方法实践

    2021-08-22 22:52:30
  • MySql存储过程与函数详解

    2024-01-13 16:32:56
  • SQL SERVER迁移之更换磁盘文件夹的完整步骤

    2024-01-25 18:37:59
  • Django-xadmin后台导入json数据及后台显示信息图标和主题更改方式

    2021-01-07 20:38:33
  • asp之家 网络编程 m.aspxhome.com