首页
学习
活动
专区
工具
TVP
发布
精选内容/技术社群/优惠产品,尽在小程序
立即前往

程序员应该文档

80% 文档都是无效,所以多数情况下,程序员都不用文档,原因如下: 多数文档都是代码点缀或者静态记录已经实现代码,懂代码开发人员会直接看代码,不懂代码开发人员压根不会看。...文档是一件要求极高工作,就像测试驱动开发,在没有完成开发之前理解它完成之后样子。除非是逻辑复杂度极高代码,否则都应该在实现过程中摸索和调整代码结构,这种效率反而更高。...服务代码常变而文档基本很少更新,程序员经常在屎上雕花,却很少有程序员帮助别人更新文档。究其原因代码是运行,文档不用运行,错了也没人关心。所以文档和代码牛头不对马嘴经常是喜闻乐见事情。...,这种东西反而要多文档,写好文档,并且文档作为代码一部分进行 review、定期审核校验。...代码都说不清楚事,你觉着注释可以

42130

优秀程序员真的不注释

注释是多余!” 我必须得承认,每个程序员都应该有一颗追求“优雅”心,力争自己代码更易阅读和理解——不只是针对机器,还有我们程序员同行。...因为我刚接手了别人留下一个项目,关于大宗期货交易。后端代码是用 Java ,但有很多 bug 在里面,动不动就资金结算失败,甚至内存溢出,解决这些问题,只有一个办法,就是彻底搞懂这些代码。...在我看来,Java 源码作者绝对是这个世界上最优秀程序员,连他们都注释,那些声称“请停止注释”号召者是不是啪啪啪地打脸,直到打肿为止。 ?...我可能属于记忆力不好那一种,隔个十天半个月,再去回头看那些我自己敲代码,有时候真有点见着陌生人感觉:“这代码是我?怎么有点面生啊?” 大部分人代码都要升级重构,对吧?...在你代码之前,脑子里肯定要想清楚你实现什么,怎么实现,把这些作为注释写下来绝对可以帮助你写出更优雅代码。

64410
  • 您找到你想要的搜索结果了吗?
    是的
    没有找到

    AI帮我代码,程序员真的失业了?

    此时此刻大叔脑海中有一个大胆想法,如果有一款工具,能反过来根据注释自动给出编程代码,是不是程序猿们都会笑合不拢嘴,爽歪歪?...今天大叔就给大家介绍一下这款工具,简单来说,通过 Copilot,程序员只需输入注释,即可自动生成代码!...首先安装插件 Copilot 安装插件后登录,按照提示操作即可,有一点特别注意,在登录 GitHub 时,不要启动 fastgithub!...复制 Device code 输入 Device code 插件安装成功 使用方式很简单,在代码过程中 Copilot 会给出提示,按 tab 接受建议即可。...通过注释提示代码 通过方法名称提示代码 总结 Copilot 可以让编程省时省力,省去基础代码时间,让程序猿把更多精力花在整体架构设计或者逻辑实现上。不过到底怎么样,还是要用一用才知道

    75510

    程序如何简历(附简历模板)

    程序简历力求简洁明了,不用设计上过于复杂,过于花哨。 校招生一页简历就够了,社招的话两页简历便可。...大家可以基于这个模板 不定期修改自己简历 谨慎使用精通两字 应届生或者刚毕业程序员在简历时候 切记不要写精通某某语言,如果真的学很好,推荐熟悉。...项目经验应该如何 项目经验中突出自己贡献,不要描述一遍项目就完事了,突出自己贡献,是添加了哪些功能,还是优化了那些性能指数,最后再说说受益怎么样,例如这个功能被多少人使用,例如性能提升了多少倍...简历上很多范范内容,什么都一点,这会放大面试官问问题范围,而且稍稍往深一问,同学们就回答不上来的话,那这场面试可能机会就不大了,希望大家知道这么个道理。...博客,不一定非要是技术大牛才博客,大家都可以博客来记录自己收获,每一个知识点 大家都可以一篇技术博客(自己刷过题,自己准备面试时候知识点等等) 如果从来没有写过的话,我建议现在大家就去注册一个博客

    1.2K20

    程序成长—— 你代码有生命力

    做了五年多程序员了,回过头来看了看以前发一些帖子,颇有一番感想。...他一开始访问数据库也是用自己方法(函数),和我思路也基本差不多,但是当他遇到SQLHelp 后感觉自己没有SQLHelp 好,于是就放弃了自己代码,转而使用SQLHelp 了。...我也遇到了同样问题,我也是先写自己访问数据库函数,但是当我遇到SQLHelp 后,并没有放弃我自己函数,而是修改我自己函数,让她更加强大!这就是代码成长! 为什么要说这些呢?...比如在乙项目的时候,实现一个功能,这个功能已经在甲项目中很好地实现了,那么您会怎么做呢? 1、把甲项目里对应代码copy过来,然后改一改,OK。...在乙项目的时候又学习了一些新技巧,可以提高效率,而且这种方法不仅适合乙项目,而且对宇甲项目也是适用,那么乙项目写好了之后,会不会应用到甲项目? 1、不会修改甲项目。

    62360

    代码全靠复制粘贴程序员,可能失业了

    首先是搜索问题:为找到连贯代码,我们需要在一系列合适备选方案中进行搜索,并且需要设定基本参数(如程序空间等)和搜索方法。...其次是排序问题:如果在搜索到程序中,有多个程序输入输出是一样,我们该选择哪一个?这都需要具体问题具体分析。因此,首先需要为程序段合成选择合适编程语言。...这个系统通过自我训练能够变得更聪明,能够构建出若干个代码段最佳组合以及在特定位置选择最合适程序段。随着这个系统不断自我学习,它能够具有越来越快运行速度。...有程序员说,像这样系统不能通过小代码片段构建更大规格项目。这种说法,就像是吹着口哨过坟场——给自己壮胆罢了。 很多程序日常工作就是将代码进行分解然后进行重组。...对于这样工作,可以通过深度学习系统很好地完成。我想这应该是一个实现数据库基本增删改查功能最伟大解决方案。事实上,这种系统出现可能意味着入门级程序集体失业。

    1.5K70

    你了解?小程序怎么在硬件设备上运行

    伴随着科技技术日益发展、小程序技术不断成熟,很多开发运营者们都发现小程序“即用即走、轻量开发”特性十分符合多种硬件设备使用方式。...在目前微信、百度、支付宝、今日头条等各个巨头把持小程序技术尚未开放背景下,市面上能够进行选择可商用程序技术变得十分窄。...一、脱离微信、百度、支付宝,小程序怎样才能在硬件设备运行?...在日常程序使用场景中,90%程序都在微信、支付宝、百度、高德等巨头App应用中打开,脱离了超级App,小程序能在智能终端自有应用中运行吗?答案当然是:可以!...二、小程序运行安全要如何确保?小程序以及用户数据是否会运行在第三方不可控环境里?小程序在硬件设备中运行是否能保障数据安全?如何保障应用运行安全,规避用户隐私数据泄露成为开发者们必须解决问题。

    1.2K30

    你还在傻傻驱动

    因为工作项目中8位单片机经常用microchip,而32位常用NXP,而两家都在积极推广自己芯片配置,代码生成工具,microchip有MCC,而NXP有MCUXPressoConfig Tools...,今天我们都来看看这么好工具你用了吗?...首先来看MCC,最为microchip新开发工具MPLAB X一个插件,安装后极大方便了工程师开发,加速项目评估,不夸张说几分钟就可以完成外设驱动开发,例如我们以PIC16f18324来说,使用...生成代码, ? 可以看到生成代码,结构清晰,注释完美,简直是工程师减少加班利器。...借用这些工具使你快速评估产品原型,加速产品开发周期,随着控制器和处理器越来越复杂,开发急需借助这些工具,让你从0开始这些控制器外设驱动,写完后还得调试,估计得一段时间,有这么好工具,又是免费,为什么

    1K60

    代码真的规范

    相信很多人都有这样经历,做项目经常都是需求赶着自己,加班加点完成功能开发,盼望着浏览器控制台不要出现红色报错,惊险通过QA测试,最后期盼着能够按时完成成功上线。...控制台没报错,功能正常并不代表自己代码是符合规范,更不能代表代码是没有隐患,我们需要一个更严谨工具来校验自己代码。而这个工具就是今天在这里介绍Eslint。...jsx代码校验工具,可以通过配置校验规则来避免代码里出现一些低级错误和统一代码风格。...这种错误很容易犯,而且chrome是不会报错!! }); 标点符校验 自己代码时候,经常会多加一些标点符号,比如上面对象属性最后逗号。或者经常遗忘一些不重要标点符号,比如分号。...后语 刚开始用时候,你可能会被惊吓,不少error和一堆warning,看到心累,但是它可以给你代码提供很严谨校验,并准确指出代码具体位置和问题信息,修改起来也并难。

    1.2K40

    Python代码规范

    2.常用标准 PEP8 里面有很多规范,作为一个业余程序员主要分享以下一些比较常用规范。...2.5空格 合适空格会增加可阅读性,比如英文和中文之间留有一个空格,这样看起来会相对比较舒服。在 Python 代码中亦是如此。但是空格不可滥用。...,但是前提是注释够好够清晰,要不然不仅不会起到帮助作用,反而会扰乱视线。...3.在Jupyter_notebook使用 上面讲了几种规范,我们可以严格按照上面的规范去代码,按照规范去做,总觉得会有种束缚,不太舒服,可是不按照规范去,写出来代码确实不太美观有不易读,那可怎么办呢...选中你规范化代码,然后点击菜单栏中「小锤子」,即可完成代码规范,就是这么简单。 ?

    1.5K30

    怎样程序员才算成功?他真心喜欢代码?【程序员002】

    当前在众多人眼中是否成功重要标准就是是否赚足够多钱,毕竟“钱”是生存、养家糊口根本! 程序员这份职业被社会认可并推崇,很多人都认为这个岗位能赚很多钱,真的是这样?...很多人也知道程序员开发软件经历比较痛苦加班码代码,确实辛苦,所以也愿意支付较高薪酬。...程序员把自己软件事情基本上当成一份工作更多一点,一个完整项目经历需求分析、软件模块分析、数据库建设、界面设计、逻辑开发、各种算法、软件测试、软件文档和用户手册等,要做事情实在太多了,所以才需要团队来完成...程序员也是人,工作大多也是为了生活。想要有一个美好生活就必须“努力工作”!程序完成一个项目,需要经过无数次软件调试与沟通,工作量实际上是很大,可以算得上“努力工作”。...但是这样生活,程序员真的喜欢

    26040

    别再傻傻地代码,程序认证安全防护知识你了解

    三、客户端强验证 应用程序可以使用第二因素来检测用户是否可以执行敏感操作,典型示例为SSL、TSL客户端身份验证,又称SSL、TSL双向校验,该校验由客户端和服务端组成,在SSL、TSL握手过程中发送各自证书...,就像使用服务端证书想证书颁发机构(CA)校验服务器真实性一样,服务器可以使用第三方CS或自己CA校验客户端证书真实性,为此,服务端必须为用户提供为其生成证书,并为证书分配相应值,以便用这些值确认证书对应用户...四、认证错误信息 认证失败后错误信息,如果未被正确实现,可被用于枚举用户ID与密码,应用程序应该以通用方式进行相应,无论用户名还是密码错误,都不能表名当前用户状态。...错误相应示例: 登录失败,无效密码; 登录失败,无效用户; 登录失败,用户名错误; 登录失败,密码错误; 正确相应示例: 登录失败,无效用户名或密码 某些应用程序返回错误信息虽然相同,但是返回状态码却不相同...五、防止暴力破解 在Web应用程序上执行暴力破解是一件非常容易事情,如果应用程序不会由于多次认证失败导致账户禁用,那么攻击者将有机会不断地猜测密码,进行持续暴力破解,直至账户被攻陷。

    99620

    单例真的对

    单例模式是设计模式中最容易理解、最容易上手设计模式,同时也是最容易出错设计模式。它实现写法有多种,但是并不都是正确写法。...1饿汉模式 饿汉,即迫切、立马,所以饿汉模式又称作立即加载,下面代码实现是它最普遍写法。...4懒汉模式双检查版 为了解决上面出现效率低问题,对代码进行了修改。...这里volatile是为了禁止指令重排序,能保证happens-before relationship,所有的都将先行发生于读。...需要注意是,在JDK 5之前版本中使用volatile并不能完全阻止指令重排序,原因是Java内存模型存在缺陷导致。 6静态内部类实现 静态内部类方式是推荐一种实现写法。

    72740

    程序员竟然是技术无产阶级,过于真实,我举报了

    之后一查,这段文字竟然是刘慈欣,出自于他科幻小说《2018 年 4 月 1 日—刘慈欣》。 一个科幻作家,竟然把 IT 程序员这个行业研究这么透彻,真的是过于真实了。...以前我们经常自嘲自己是码农,码畜,而刘慈欣已经把我们现在工作比喻成彻夜赶工般妓女,说我们是「技术无产阶级」。 你们感觉真实?...其实,回过头去想想,随着时代发展,从互联网到移动互联网再到所谓的人工智能智能时代,大数据,云计算,世界可能确实也越来越需要程序员,程序员也越来越多,然后再想想我们自身工作,每天重复复制,粘贴,确实像码头搬运工...可能世界上 80% 程序员干工作都是这样,只有那 20% 程序员在为那 80% 程序员提供者他们需要搬砖。 再想想我们之前有人调侃人工智能背后,智能都是来自于人工。...程序员,算法工程师写了智能算法,而算法要想智能,就需要大量数据来训练,我们不得不投入大量工程师去打标签,去做数据,去喂饱算法。 这么一想我们程序员真的干的确实只是脑力体力活。

    1K10

    程序应该注意地方

    程序应该注意地方: 1. 对于文本编辑框,一定要判断是否含有非法字符。对于数字型一定要判断是否含有非数字。对于字符型,一定要判断是否在允许字符内。 2....输入路径长度是否超过了最大字符长度。 4. 对于要写进数据库值,一定要判断是否超过了字段定义长度。 5. 在往网络某一个文件夹数据时,判断是否可写。 6....在做长时间操作时,一定要使鼠标变成漏斗型,让别人知道你程序还在运行。最好用一个进度条来显示进度。给用户继续等下去信心。 9....对于菜单条中的菜单项,最好在工具条上做一个快捷方式,用户都很懒,巴不得坐在那里,不动键盘和鼠标,你程序都能工作。 10. 操作系统中文件夹和文件是不区分大小写,但写在程序代码是区分大小写。...在往硬盘或数据库数据时,最好先写往缓冲区,然后一次性写入,这样可以加快速度。 14. 参数在命名时,尽量取要有意义,不要到处是a,b什么。。一个函数不要写太长,注释。

    70930
    领券