首页
学习
活动
专区
圈层
工具
发布
    • 综合排序
    • 最热优先
    • 最新优先
    时间不限
  • 来自专栏程序员维他命

    如何提高代码的可读性? - 读《编写可读代码的艺术》

    《编写可读代码的艺术》封面 一. 以上这些细节上的东西非常影响代码的可读性。 相对于追求最小化代码行数,一个更好的提高可读性方法是最小化人们理解代码所需要的时间。 这就引出了这本中的一个核心定理: 可读性基本定理:代码的写法应当使别人理解它所需要的时间最小化。 这本书讲的就是关于“如何提高代码的可读性”。 最后想说的 这本书从变量的命名到代码的组织来讲解了一些让代码的可读性提高的一些实践方法。 其实笔者认为代码的可读性也可以算作是一种沟通能力的一种体现。

    1.4K10发布于 2018-08-30
  • 来自专栏多选参数

    可读代码编写炸鸡一

    包括我在内,许多人的代码可读性其实一塌糊涂。先不从代码组织,设计模式这些较大的方面来说。光是一个变量,一个函数的命名,注释的规范都没有提供帮助理解 的作用,让人看的一头雾水。 代码的编写规范,是很少人去注意的,这段时间,我的主程让我看一本书 ——《编写可读代码的艺术》,正好直击痛点,于是我打算写一写关于这个方面的东西。 希望通过这个系列的炸鸡,能让我和各位在代码可读性上,有所进步。 前提准备 在阅读本篇前,先得了解一些原则。 基本可读性定理 代码应该写得让人在最短时间内理解。 但是再过些时日再看,你自己都会摸不着头脑了,这样代码的可读性是很差的。 所以,命名应该表达更多的信息。

    54010发布于 2020-04-07
  • 来自专栏原创分享

    nodejs可读流源码分析

    可读流是对数据消费的抽象,nodejs中可读流有两种工作模式:流式和暂停式,流式就是有数据的时候就会触发回调,并且把数据传给回调,暂停式就是需要用户自己手动执行读取的操作。 我们先看一下ReadableState,这个对象是表示可读流的一些状态和属性的。 nodejs只是抽象了流的逻辑,具体的操作(比如可读流就是读取数据)是由用户自己实现的,因为读取操作是业务相关的。下面我们分析一下可读流的操作。 1 可读流从底层资源获取数据 对用户来说,可读流是用户获取数据的地方,但是对可读流来说,他提供数据给用户的前提是他自己得有数据,所以可读流首先需要生产数据。生产数据的逻辑由_read函数实现。 2 用户从可读流获取数据 用户可以通过read函数或者监听data事件来从可读流中获取数据 Readable.prototype.read = function(n) { n = parseInt(

    1.1K30发布于 2020-07-22
  • 来自专栏多选参数

    可读代码编写炸鸡三 - 审美

    在上一篇 可读代码炸鸡二(下篇) - 命名的歧义 的结尾处,提到了接下来的炸鸡会围绕 多行代码,多个函数 的代码范围来讨论代码可读性的优化。 由这个思路走的话,那么接下来的炸鸡大致会分成两个内容: 代码审美 代码注释 所以本篇炸鸡将讨论 代码审美 对于可读性的作用。 原则 一致布局,让读者很快习惯。 相似代码看起来要相似。 private: double minimum; list<double> past_items ;double maximum; }; 然后做一点审美层面的修改,你再看看,可读性瞬间提高 所以最终还是就 是否可读性,使得阅读者理解更快理解 这一标准衡量。

    48910发布于 2020-04-07
  • 来自专栏腾讯社交用户体验设计

    SVG fallback 及可读

    SVG的可读性 由于SVG采用的是XML的语法,图形的里的文本内容可以被浏览器,搜索引擎和读屏软件读取,所以本身具有可读性好,有利于SEO,对无障碍友好等特点。

    86330发布于 2018-06-29
  • 来自专栏C语言

    提高程序可读

    提高程序可读性 点开这篇文章,意味着你有想成为更好的程序员的决心,那么请认真阅读以下内容: 在编程过程中注意提高程序的可读性是良好的编程习惯,这使程序更易于理解,也更容易在以后进行修改和更正。 为了避免步入代码的wading,可读性是必要的。 技巧3:函数的使用 1)减少嵌套 多层嵌套会大幅度降低程序的可读性,我们可以借用函数来减少嵌套 2)避免重复 重复的代码块可能意味着某种想法未在程序中清晰的表达出来,这也削弱了代码的可读性。 利用函数包装重复代码块,可以使程序更整洁 3)代码模块化 当代码量比较大时,对代码进行模块化,根据各个部分的不同功能进行打包区分,包进函数里,可以使程序看起来整齐有序,提高可读性。 0;//case 2 最后 正如《代码整洁之道》一书中的“花时间保持代码整洁不但有关效率,还有关生存”,毕竟混乱会导致团队生产力下降,又制造更多混乱,最终效率趋向于零… 因此,在编码过程中注意提高程序可读性就显得至关重要

    55220发布于 2021-02-22
  • 来自专栏磐创AI技术团队的专栏

    增强分析可读性-Pandas教程

    可读格式 我收到的最常见的评论是,你能把数字四舍五入,并使用符号,如M表示百万或K表示千?这将使你的表看起来更好,并减少不必要的信息。很多时候,我们不需要这么精确。 def human_readable_format(value, pos=None): ''' 将数据帧中的数字转换为可读格式 `pos` 参数与matplotlib ticker 你可以使用与表格类似的可读格式设置此图形的y轴 import matplotlib.ticker as mticker import matplotlib.pyplot as plt fig , ax

    1.3K40发布于 2021-04-21
  • 来自专栏企鹅号快讯

    什么叫代码的可读性?为什么说Kotlin的可读性比Java好?

    里面有一段是关于Kotlin与Java之间可读性的对比的文章,作者的结论是:Kotlin并不比Java更具有可读性,所有认为Kotlin 比Java更具有可读性的结论都是“主观性”的。 所以,这个例子是不能代表大写这种风格的可读性的。在比较两种不同的风格的可读性的时候,你不能用具体的某一个一次性的片段来说明。 另外,这篇文章还暗含了这样一个观点,那就是,代码的可读性,仅仅是指,看到一段代码,能不能理解这段代码的含义。这是一个很多人都会错误的观点。 但是,在真正工作中,代码的可读性,恐怕不至这一个方面。 为什么代码的可读性这么重要? 以上从三个方面解释了什么叫代码的可读性,可以看到,无论在哪个方面,Kotlin都有比Java更大的优势。那接下来的一个问题就是,So what?可读性有这么重要吗? 别说,可读性还真可以吃,而且很值钱! 关于可读性的重要性,其实上面分析什么叫可读性的时候,已经提到了,这里归纳一下,只说两点: 更快的找到你关心的代码,更快的理解代码。

    1.4K70发布于 2018-01-10
  • 来自专栏编程之旅

    使用Block提高代码可读

    但是在最近封装代码的时候,我发觉delegate对于我自己定义并编写代码来说,可读性和使用性很好,但是当他人来使用我封装的代码的时候,也许Block更容易被理解一点。 大大提高了代码的可读性。 我认为,程序员首先是写人能看得懂的代码,顺便运行。 在这个理念的驱使下,我大概会在之后的开发过程中,对可读性这个概念更上心一点,能用block处理的事件,尽量的用block处理。 当然如果你已经厌烦了一直使用delegate模式来编程的话,偶尔转转写一些block,不仅可以锻炼思维,也能让你写的代码看起来高端洋气一些,而且因为代码跳转变少,所以可读性也会增加。 代码的可读性是否如愿提升了呢。 简单的栗子讲到这里,Coding还是需要多写多思考的。

    58230发布于 2018-08-30
  • 来自专栏潇湘信安

    Windows常见可读写目录的探测

    0x01 前言 实战中如到某虚拟主机,磁盘权限设置较为严格,cmd.exe被降权执行不了命令,常见可读写目录也不能读,这时就需要用到探测可读写的脚本来查找可读写的目录和文件,用于上传cmd.exe和提权 也可查找可读写的系统文件上传覆盖执行,实战案例可参考之前写的:VHAdmin虚拟主机提权实战案例 0x02 常见可读写目录 扫描可读写目录 C:\Users\ C:\Windows\ C:\ProgramData \ C:\Program Files\ C:\Program Files (x86)\ C:\Documents and Settings\ ≤2003可读写目录 C:\RECYCLER\ D:\RECYCLER \Windows\Debug\ C:\Windows\Registration\CRMLog\ C:\Documents and Settings\All Users\Documents\ ≥2008可读写目录 8608-00C04FC295EE}\ C:\Windows\System32\catroot2\{F750E6C3-38EE-11D1-85E5-00C04FC295EE}\ 0x03 脚本下载 常用可读写目录探测的各类脚本可关注

    1.3K10编辑于 2022-09-22
  • 来自专栏iOS开发大全

    开发入门之Web 品质- 可读

    Web 品质- 可读性 ---- Web品质-可读性技术文档 可读性是网站品质的重要方面,它直接影响用户的使用体验和网站的可维护性。因此,在设计和开发过程中应该注重提高网站的可读性。 本文将介绍如何通过一些技术手段提高Web网站的可读性。 1. 字体和排版 1.1 字体选择 选择合适的字体对于网站的可读性非常重要。 为了提高网站的可读性,在设计导航时应该遵循以下准则: 正确的分类 易于理解和识别 逻辑分组 易于找到和使用 4. 可访问性 网站的可访问性也是很重要的。 为了提高网站的可读性,网站应该: 遵循有关无障碍访问的指南。 确保网站可以访问,并且易于使用。 为盲人和弱视用户提供可访问的内容。 结论 通过上述技术和方法,我们可以提高网站的可读性,改进用户的使用体验和网站的可维护性。同时,我们还可以提高网站的访问速度,让用户得到更好的使用体验。

    35430编辑于 2023-10-16
  • 来自专栏多选参数

    可读代码编写炸鸡九 - 抽取子问题

    我们回顾一下,可读代码编写第二层主要是讲了 代码逻辑 上的优化。 第三层便是更大的范围了,是关于代码组织,可以说是函数级别的代码组织优化。 后台回复 「第三层」获取源文件 所以本篇炸鸡从 抽取不相关的子问题 这一点入手可读代码编写。 写在前头 对于代码的编写,大事化小,小事化了。模块化是我们很需要的一个思想。 对于代码可读性来说,还是对调用的方便来说,都是有裨益的。 而且其实在调用方便这一层面,利用函数合适的命名,也是增强了代码的可读性。 不要过分抽取 看完前面的内容,最怕的情况是过度抽取。

    69220发布于 2020-07-09
  • 来自专栏京程一灯

    抛弃变量,编写更加可读的JavaScript代码

    正确划分代码的作用域以及利用常量取代变量可以大大增加代码的可读性。从长远来看,几乎在所有情况下这都是最重要的。 命令式编程 命令式编程在今天仍然是主流的编码方式。 只要代码是可读的,容易修改的,即使它比较长也是可以的。 JavaScript本质上是命令式语言,它也有一个动态类型系统。在静态类型语言,类型系统提供了一些有关变量的线索。 每一次优化都是有代价的,因为它本质上是从人到电脑的可读性的转变。如果你的项目已经很快的话,那么就继续保持代码的干净和可读性。 怎样实现 使用常量 首先,你要做的最重要的事情就是将声明的变量替换为常量。 遵守这些规则一开始可能不是很容易上手而且有点奇怪,但从长远来看,代码将变得更具有可读性。

    66330发布于 2019-03-27
  • 来自专栏CSDN

    为什么强调代码的“可读性”

    为什么强调代码的可读性,其实也就是为了解决这些坑带来的问题。 你心目中的代码第一优先级要求是什么? 那么这样的话,我心目中当然是觉得代码的第一优先级应该是可读性。 因此我心目中代码的第一优先级必须是“可读性”。 你在提升代码可读性的一些做法 对于《一文聊聊代码的可读性》文中提到的代码可读性体现的三个方面:语言表达、明确意图、层次结构,我个人是比较认可的。 其实代码可读性的实现或者说习惯的建立,本身并没有那么复杂,而是很简单,只需要摒弃一些日常的坏习惯就可以做到的。比如说代码注释,代码层次结构等,都是我日常工作中提升代码可读性的常用的。 以上内容希望对大家在代码开发中提高代码可读性起到一定的帮助作用。

    30410编辑于 2024-04-22
  • 来自专栏多选参数

    可读代码编写炸鸡四(上篇) - 来写注释

    这一篇炸鸡要讲一讲 代码注释 的可读性优化。 关于注释的炸鸡的行文思路如下图所示。 ? [:2]) 因为虽然阅读者可以通过一定时间的阅读可以得出结果,但是这种 一行嵌套多个方法 的代码可读性已经下降,所以加上注释能帮助阅读者快速理解代码。

    62050发布于 2020-04-13
  • 来自专栏python3

    Python 提高元组的可读

    假设学生系统中数据为固定格式:(名字,年龄,性别,邮箱) ('jack','16','male','jack3001@gmail.com') ('eric','17','male','eric@qq.com') ('xander','16','female','lucy123@yahoo.com') 方案一: from enum import IntEnum NAME,AGE,SEX,EMAIL=range(4) s=('jim','16','male','jim8721@gmail.com') # pri

    54710发布于 2020-01-07
  • 来自专栏多选参数

    可读代码编写炸鸡十 - 保持单纯

    这篇炸鸡也是属于可读代码编写的第三层的内容,说实话我也有些生疏了,所以重新看一遍第三层的概览: ? 在《编写可读代码艺术》第十一章中提供的一张图就能很形象地描述这类情况。 ? 截图自《编写可读代码艺术》第十一章 这就是可视化的三心二意呵,很明显,这样对可读性是有很大的伤害。 毕竟提高代码的可读性的方法,本质上都是类似的。 那么就让代码保持单纯与执着,一次尽量只做一件事。 可读代码炸鸡的系列从第一层到现在的第三层,可读性提升的方法从小范围到大范围,提供了许多方法与建议。

    46640发布于 2020-08-04
  • 来自专栏全沾开发(huā)

    使用JSDoc提高代码的可读

    使用JSDoc提高代码的可读性 工作了四年多,基本上都在围绕着 JavaScript 做事情。 在重构同时我们还是需要继续维护原有的 JavaScript 项目的,而 JSDoc 恰好是一个中间过渡的方案,可以让我们以注释的形式来降低 JavaScript 项目的维护难度,提升可读性。

    1.7K20发布于 2019-12-09
  • 来自专栏全栈程序员必看

    ioctl() FIONREAD 检测socket是否有数据可读

    FIONREAD用于判断接收缓存中是否存在可读数据,用于accept的socket处于LISTEN状态,只能被动接受连接,实际上已经没有IO了,不能用FIONREAD去判断socket是否有连接,ioctl

    70020编辑于 2022-09-15
  • 来自专栏GopherCoder

    『No24: 编写可读代码的艺术(1)』

    本文结合一些简易的设计规范来解释:编写可读代码的艺术。 《写给大家看的设计书》一书中全文在诠释设计的四个规范:亲密、对齐、重复、对比。 《编写可读代码的艺术》一书中全文在诠释编写可读代码的艺术:让人易于理解。 是的,市面上存在很多很优秀的设计师,设计的作品,既足够精美,又让用户秒懂。好的设计者一定深谙心理学。 本文从这些层面讲述,如何编写可读代码。 0. 规范 绝大多数的人,不会从零完整的完成一个复杂的项目,大多是团队共同合作,完成一个大的项目。 这个时候,假如你是中途参与进来。 总结 从“表面”给出编写可读代码的建议,下一篇介绍从流程、循环、抽象、组织代码等角度谈编写可读代码的建议。 下节再会,我是谢伟。 谢谢。

    63220发布于 2018-11-07
领券