请问一下如何优雅的输入注释 - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
请不要在回答技术问题时复制粘贴 AI 生成的内容
techstay
V2EX    程序员

请问一下如何优雅的输入注释

  •  
  •   techstay
    techstay 2021-11-30 23:27:27 +08:00 2436 次点击
    这是一个创建于 1420 天前的主题,其中的信息可能已经有所发展或是发生改变。

    就比如很多配置文件里面的注释大段,我借用的时候都是直接复制粘贴,感觉好 low 了,有没有什么比较优雅的办法呢。那些作者在要写这种注释的时候是怎么处理的呢?如果有个类似ascii art generator这样的东西就好了。

    # ----------------------- # 这是注释 # ------------------------ 
    13 条回复    2021-12-01 21:15:40 +08:00
    Bijiabo
        1
    Bijiabo  
       2021-11-30 23:35:44 +08:00
    我用的是 Monodraw ,价格不贵,感觉不错
    eason1874
        2
    eason1874  
       2021-12-01 00:42:13 +08:00
    我用 VS CODE ,写好函数,输入 /** 换行它就自动帮我提供注释模板了
    vanton
        3
    vanton  
       2021-12-01 00:55:37 +08:00
    如果是 vs code ,需要一个花里胡哨的注释生成工具,可以用下这个:
    https://marketplace.visualstudio.com/items?itemName=OBKoro1.korofileheader

    koroFileHeader

    非常的花里胡哨
    BeautifulSoap
        4
    BeautifulSoap  
       2021-12-01 00:58:52 +08:00 via Android
    @vanton 这个插件除了生成佛祖,还能生成耶稣,真主吗.jpg
    vanton
        5
    vanton  
       2021-12-01 01:12:40 +08:00
    @BeautifulSoap #4

    还能生成龙、羊驼、键盘、美女什么的。

    生成图案快捷键 window:ctrl+alt+j, mac:ctrl+cmd+j

    生成头部注释 window:ctrl+alt+i, mac:ctrl+cmd+i

    当前段注释 window:ctrl+alt+t, mac:ctrl+cmd+t

    用下来还算好用
    secondwtq
        7
    secondwtq  
       2021-12-01 01:52:59 +08:00
    感觉这种注释太花,也就文件头 license 声明有点用,其他地方用处不大。

    单行最大长度限制之类的倒是很常见,还见过有的要求在没行注释之前加 * 之类的符号的(常见于 C99 之前的 C 项目 ...),这种一个 formatter 基本搞定
    hibian
        8
    hibian  
       2021-12-01 01:53:30 +08:00 via iPhone
    设置个模版
    codingBug
        9
    codingBug  
       2021-12-01 02:00:01 +08:00 via Android
    ∥ 注释

    /*
    * 注释
    */
    techstay
        10
    techstay  
    OP
       2021-12-01 02:22:52 +08:00
    @vanton 这个有点意思,冲这个神兽图案我就得装上,不过看了一下主要是添加文件头和函数头的注释,现在我还用不上。我想要的其实是类似[Comment Divider]( https://marketplace.visualstudio.com/items?itemName=stackbreak.comment-divider)这种功能,不过这个插件做的又有点太简单了,如果能把这俩结合一下就好了
    alanleung410
        11
    alanleung410  
       2021-12-01 09:44:50 +08:00
    我想找个参数自动注解的插件( Annotation ),vscode 用的
    yangzzzzzz
        12
    yangzzzzzz  
       2021-12-01 10:26:40 +08:00
    /**
    * @Author yourName
    * @Description 自己设置一个模板呗。
    * @Date 2021-12-01 10:26:13 星期三
    */
    james2013
        13
    james2013  
       2021-12-01 21:15:40 +08:00
    JetBrains 全家桶可以设置模版,然后输入指定的字符串就出来了
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     2955 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 24ms UTC 13:32 PVG 21:32 LAX 06:32 JFK 09:32
    Do have faith in what you're doing.
    ubao msn snddm index pchome yahoo rakuten mypaper meadowduck bidyahoo youbao zxmzxm asda bnvcg cvbfg dfscv mmhjk xxddc yybgb zznbn ccubao uaitu acv GXCV ET GDG YH FG BCVB FJFH CBRE CBC GDG ET54 WRWR RWER WREW WRWER RWER SDG EW SF DSFSF fbbs ubao fhd dfg ewr dg df ewwr ewwr et ruyut utut dfg fgd gdfgt etg dfgt dfgd ert4 gd fgg wr 235 wer3 we vsdf sdf gdf ert xcv sdf rwer hfd dfg cvb rwf afb dfh jgh bmn lgh rty gfds cxv xcv xcs vdas fdf fgd cv sdf tert sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf shasha9178 shasha9178 shasha9178 shasha9178 shasha9178 liflif2 liflif2 liflif2 liflif2 liflif2 liblib3 liblib3 liblib3 liblib3 liblib3 zhazha444 zhazha444 zhazha444 zhazha444 zhazha444 dende5 dende denden denden2 denden21 fenfen9 fenf619 fen619 fenfe9 fe619 sdf sdf sdf sdf sdf zhazh90 zhazh0 zhaa50 zha90 zh590 zho zhoz zhozh zhozho zhozho2 lislis lls95 lili95 lils5 liss9 sdf0ty987 sdft876 sdft9876 sdf09876 sd0t9876 sdf0ty98 sdf0976 sdf0ty986 sdf0ty96 sdf0t76 sdf0876 df0ty98 sf0t876 sd0ty76 sdy76 sdf76 sdf0t76 sdf0ty9 sdf0ty98 sdf0ty987 sdf0ty98 sdf6676 sdf876 sd876 sd876 sdf6 sdf6 sdf9876 sdf0t sdf06 sdf0ty9776 sdf0ty9776 sdf0ty76 sdf8876 sdf0t sd6 sdf06 s688876 sd688 sdf86