vscode自动添加python文件的头部注释

背景: 利用vscode 进行相关配置后可以自动添加头部注释,比如作者信息,文件创建时间、最后修改时间等。 

实现: 

vscode的插件扩展中:安装 koro1FileHeader 插件。  自动添加头部注释和更新时间。 先配置settings.json (ctrl+shift+p 输入settings.json 打开), 参考: https://github.com/OBKoro1/koro1FileHeader/wiki/%E5%AE%89%E8%A3%85%E5%92%8C%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8B

配置模板: 

"fileheader.customMade": {
    // Author字段是文件的创建者 可以在specialOptions中更改特殊属性
    // 公司项目和个人项目可以配置不同的用户名与邮箱 搜索: gitconfig includeIf  比如: https://ayase.moe/2021/03/09/customized-git-config/
    // 自动提取当前git config中的: 用户名、邮箱
    "Author": "YunTian", // 同时获取用户名与邮箱
    // "Author": "git config user.name", // 仅获取用户名
    // "Author": "git config user.email", // 仅获取邮箱
    // "Author": "OBKoro1", // 写死的固定值 不从git config中获取
    "Date": "Do not edit", // 文件创建时间(不变)
    // LastEditors、LastEditTime、FilePath将会自动更新 如果觉得时间更新的太频繁可以使用throttleTime(默认为1分钟)配置更改更新时间。
    // "LastEditors": "git config user.name && git config user.email", // 文件最后编辑者 与Author字段一致
    // 由于编辑文件就会变更最后编辑时间,多人协作中合并的时候会导致merge
    // 可以将时间颗粒度改为周、或者月,这样冲突就减少很多。搜索变更时间格式: dateFormat
    "LastEditTime": "Do not edit", // 文件最后编辑时间
}
保存文件的时候,自动更新最后的编辑时间和编辑人。 使用的快捷键 window:ctrl+win+i,mac:ctrl+cmd+i
### 如何在 VSCode自动添加文件头部注释 #### 配置方法 为了实现文件头部注释自动生成,可以通过安装扩展并调整其配置来完成。以下是具体的操作方式: 1. **安装 KoroFileHeader 插件** 安装名为 `KoroFileHeader` 的插件可以帮助用户轻松地为新创建的文件添加头部注释[^1]。 2. **编辑 settings.json 文件** 在 VSCode 的设置文件中加入如下配置项以控制头部注释的行为: ```json { "fileheader.configObj": { "autoAdd": false, // 设置为 true 可启用检测无头部注释自动添加功能;建议设为 false 并手动管理需要添加头部注释文件 }, "fileheader.customMade": { "Author": "Your Name", // 替换为您自己的名字或团队名称 "Date": "Do not edit", // 自动生成日期 "Description": "" // 自定义描述字段 } } ``` 3. **启用 Python 文件特定头部注释** 如果专注于 Python 文件,则可以在上述配置的基础上进一步定制化。例如,在新建 `.py` 文件时会自动填充作者信息、创建时间和简短说明等内容[^2]: ```json { "[python]": { "editor.codeActionsOnSave": { "fileheader.addOrReplace": true } } } ``` 4. **单行或多行注释样式支持** 不同语言有不同的注释风格需求,而通过合理利用这些语法特性能够使文档更加清晰易读。对于大多数现代编程环境而言,默认情况下都已内置对基本形式的支持,如 C++/Java 使用双斜杠 (`//`) 表达单行含义以及连续多条构成块级结构[^3]。 #### 推荐扩展 除了提到的核心工具外还有一些辅助类别的选项值得考虑引入到日常开发流程当中去提升效率与一致性水平: - **Document This**: 提供更强大的 API 文档生成功能。 - **Auto Comment Blocks**: 方便快速包裹选中的代码片段成为大段落式的备注区域。 ```python # 示例:Python 文件生成后的效果 """ @author: Your Name @created: ${DATE} @description: A brief introduction about this script. """ ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值