惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

月光博客
月光博客
freeCodeCamp Programming Tutorials: Python, JavaScript, Git & More
N
Netflix TechBlog - Medium
大猫的无限游戏
大猫的无限游戏
爱范儿
爱范儿
Martin Fowler
Martin Fowler
OSCHINA 社区最新新闻
OSCHINA 社区最新新闻
The Register - Security
The Register - Security
IT之家
IT之家
博客园_首页
Microsoft Security Blog
Microsoft Security Blog
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
博客园 - 三生石上(FineUI控件)
I
InfoQ
CTFtime.org: upcoming CTF events
CTFtime.org: upcoming CTF events
Jina AI
Jina AI
Apple Machine Learning Research
Apple Machine Learning Research
M
MIT News - Artificial intelligence
博客园 - Franky
C
Check Point Blog
T
The Blog of Author Tim Ferriss
V
Visual Studio Blog
Cyber Security Advisories - MS-ISAC
Cyber Security Advisories - MS-ISAC
T
Tailwind CSS Blog
Recent Announcements
Recent Announcements
云风的 BLOG
云风的 BLOG
美团技术团队
The Cloudflare Blog
Y
Y Combinator Blog
H
Hackread – Cybersecurity News, Data Breaches, AI and More
MyScale Blog
MyScale Blog
The GitHub Blog
The GitHub Blog
D
DataBreaches.Net
Google DeepMind News
Google DeepMind News
V
V2EX
aimingoo的专栏
aimingoo的专栏
GbyAI
GbyAI
G
Google Developers Blog
S
SegmentFault 最新的问题
Hugging Face - Blog
Hugging Face - Blog
奇客Solidot–传递最新科技情报
奇客Solidot–传递最新科技情报
U
Unit 42
罗磊的独立博客
量子位
MongoDB | Blog
MongoDB | Blog
Last Week in AI
Last Week in AI
Stack Overflow Blog
Stack Overflow Blog
小众软件
小众软件
D
Docker
人人都是产品经理
人人都是产品经理

Mobility

从薅 token 到管 skill:我的 pks 工具落地实践 把笔记、微信读书、知乎装进 Obsidian:我基于llm-wiki知识中枢搭建实录 免费AI视频生成器:我如何用零成本做出带旁白字幕的多场景AI视频 Agnes免费模型真能白嫖视频?我改造了ViMax来试试 教你薅token(二):构建agent无关的skills管理工作流 教你薅token:构建agent无关的AI工作流 用 AI Agent 完成 Hexo 主题迁移:从 Next 到 Butterfly 的全自动化实践 Vercel封禁163邮箱后,我是怎么恢复博客的 用LLM管理安全开发规范:一次llm-wiki实践 Vaadin框架教程:Java工程师的前端开发秘籍 hexo多语言方案总结及最佳实践 知乎增强工具-评论时间精确到秒 怎么理解数据库的四个隔离级别 kubernetes是什么-实用向教程 怎么更科学的用知乎摸鱼 读书笔记《系统之美》,如何面对现实中的复杂问题 分布式系统设计中的通用方法 高并发解决方案很难吗?轻松聊清楚高并发设计 SSP,DSP,RTB,ADX都是什么? 讲讲互联网广告的概念与发展 从redolog,undolog到隔离级别,刨根问底,讲清楚事务和ACID java项目低学习成本使用kubernetes的实践经验 剧变中的2021-一个中年工程师的年终总结 kubernetes环境下做金丝雀发布的一种思路 prometheus教程: 一篇文章讲懂prometheus 实现一个简单的java版本高性能获取ip地址所属国家工具 iterm2配置ssh书签, 实现记住密码和自动登录 怎样做一个好的技术分享 云原生究竟是什么 读书笔记 稻盛和夫《干法》-思考应该怎样去工作 review的个人价值 户口?大厂?高薪?生活?聊聊应届程序员的职业选择 RPC接口将所有输入输出封装成类是合理设计吗 程序员做业务开发的价值 设计模式的原则,设计模式究竟是什么 我提升开发效率的经验 信息传播过程中的衰减 看房小记-2020北京学区 读书感悟:文明、现代化、价值投资与中国 读书笔记-我曾走在崩溃的边缘 [翻译][关于分布式架构和系统设计]分布式系统的模式-综述 redis的对象 redis里的数据结构 设计模式备忘录 聊聊程序员的职业生涯,我对程序员这个职业的理解 通过mysql批量操作不生效问题聊聊java里mysql的batch 【实践经验】单元测试怎么写 关于rocketmq的readQueue和writeQueue 数据分析的利器-clickhouse介绍 通过位运算转换大小写 activemq多线程消费的不同处理方式 高并发下作余额扣减的一些经验 java细节:三目运算符和自动拆箱 设计一个开源的北京地铁路线规划小工具 java版本 redis cluster的数据迁移 jstorm源码解析之循环任务AsyncLoopThread activemq特性之持久化 activemq的安装及基本使用 activemq系列-概述 hexo教程:博客系统搭建及部署到github jstorm的监控metrics数据输出到第三方存储介质 camel系列之camel debugger的使用 jstorm源码解析之bolt异常处理 log4j动态添加appender 【翻译】java里编写基准测试的一些经验 java线程池:获取运行线程数并控制线程启动速度 maven里的mirror和repository: 配置多repository 使用maven shade plugin 打可执行Jar包 activemq plugin开发指南及示例 通过加入classpath的形式实现命令行运行java程序时引入第三方jar包 解决fatjar的 “java.lang.SecurityException: Invalid signature file digest for Manifest main attributes” 问题 通过实际操作理解redis cluster原理 一种实现在hbase中存储set的思路 log4j2.xml配置示例及与log4j的区别 不实现equals方法的情况下比较java list 使用lua脚本和jedis实现redis的hmsetnx命令,操作hash表时不覆盖原有数据 vitualbox虚拟机安装centos 7 及ssh访问、自启动等配置 在java独立进程(standalone app)中嵌入hawtio监控 java日志系统简介: 从tomcat大量打印debug日志说起 Java kryo/protobuf/protostuff序列化 or Json 性能对比 java分布式锁入门实战 leetcode第三题: 输出不包含重复字母的最长子串 java多线程实现三个字母顺序输出 一次kafka空间激增排查:kafka的数据压缩、批量发送等 java里128有何魔力? 聊聊Integer的缓存 storm/jstorm生态与周边工具,storm连接activemq,kafka,hdfs等 jstorm UI 介绍 五分钟学会写storm代码: jstorm/storm编码原理与普通java程序的区别 activemq web console的权限配置 storm ui 中一些关键属性的含义 activemq 5.6 连接池的内存泄露问题 关于apache camel的消息转发效率 一篇不错的lda模型入门文档 wordcount代码 hadoop基本的学习资料
通过合理的设计降低软件开发复杂度
流沙 · 2021-01-04 · via Mobility

对于一个程序员来说,日常最常说的词恐怕就是「复杂」了,这段代码太复杂了,这个逻辑太复杂了,所以,在这篇文章里,我们就好好掰扯掰扯「复杂」到底是怎么产生的,又要怎么去避免。

复杂度的产生

我们先列一下当我们在说「复杂」的时候,到底在说什么。

  • 没有模块划分,整个一大坨代码摊在那儿
  • 大量的重复代码
  • 代码整体逻辑看不懂
  • 本来一个很简单的需求,改的时候发现这也要改,那也要改
  • 代码没办法迁移,没办法复用
  • 整天有莫名的bug出现

上边列的这些问题,其实很多之间是互为因果的,比如模块划分的不好,导致了代码逻辑看不懂,也导致了代码没法复用,代码没法复用,又导致了大量重复代码,重复代码又进一步导致代码逻辑看不懂。

所以,下面我们尝试着规整一下这些问题,看看问题到底在哪。

我觉得,首先可以把代码复杂度的问题简单分个类,一类是代码本身的问题,一类是代码对现实世界的表现力的问题。前者主要关乎代码整体的整洁程度,以及容不容易进行持续的维护;后者则主要影响代码容不容易理解,别人看代码时是否需要大量的背景知识。

对代码本身问题来说,以我的观察,导致代码过度复杂的首要原因就是模块拆分不清晰,甚至没有模块拆分。像上边列的重复代码、无法复用、统一逻辑多处修改等问题,本质原因都在模块拆分。另外有一些命名上的问题,会导致代码进一步不可维护。

关于代码对现实世界的表现力,我觉得一个很大的问题就是代码和现实割裂太严重,导致单纯依靠业务上的背景知识,并不能理解代码的实现方式;同时,当你以一个不符合现实的设计去实现现实需求的时候,可想而知,每一步都会很难。比如说,一个展示用户机票的业务,上游各航司的数据key都是「用户证件号」,那你这儿的key应该是什么呢,也是证件号吗。如果这么做了,然后再如果做了分库分表,可以想一下,「查询用户最近一张机票」这么一个基础功能,实现起来要有多复杂。

其实理到这儿,会发现已经能基本涵盖一开始列的那些问题了。像bug多这类问题,其实是逻辑复杂的一种表现。因为逻辑复杂,看不懂,所以Bug才多。

另外,有一个问题是上边说的每个点,随着程序规模的增加,会出现一个指数级的放大效应。相信很多人可以感受的到,如果有一个5天工作量的需求,和5个1天工作量各自独立的需求,最后做下来,前者实际花费的时间和最后产生的bug都要多很多。

所以,接下来我们就对上边这些提供一些解决方案

解决方案

拆分

首先,重中之重,就是做好拆分,要做好每个层次的拆分,比如微服务的边界怎么划分,哪些内容放到一个类里,哪些内容放到一个方法里。不夸张的说,模块拆分的好,可以解决开发上80%以上的问题。

比如,「把大象装进冰箱需要三步,一打开冰箱门,二把大象放进去,三关上冰箱门」,这就是一个非常合理的模块拆分。当然,对于三步中的每一步来说,都可以进一步细化。比如打开冰箱门包括:握住把手,用力拉两步;把大象放进去,包括,找一个大力士,举起大象,放到冰箱里,松手,四步。

拆分的核心要素是要拆的合理。对于业务逻辑来说,就是要符合对现实世界的认知。比如上面的例子里,你不能强行包一个「用力拉,找大力士,举起大象」这样的方法。但是,这个现象,在实际的业务开发中,实际上非常常见。很多人看到一个方法太长,知道要做下拆分,结果只是随机的从代码里拉住一块,抽了出来。这样,实际上只能让代码看着好一点,无法达到降低复杂度的效果。

另外,拆分没有止境,每个子模块,都可以进一步拆分成更细的子模块,直到这个模块已经足够容易理解。

高内聚

在这儿说内聚,主要就是说要把复杂度控制在最小的范围内。以上边的例子来说,「找大力士」这一步就是最复杂的,因为根本没有这样的大力士。但是,这儿的复杂度只是这个小模块的内部实现,只有这一个小模块复杂,在上层或者其他模块是不应该感受到这个复杂度的。

但是,实际开发中,我们经常看到一些底层很复杂的结构,不断的暴露在系统各个层次、各个模块中,导致复杂度无法收敛。这样,随着项目规模的扩大,整体的复杂度就会呈指数级上升。

命名

这个就比较细节了。命名的核心要求一是要准确,无论是变量名、方法名,看到这个名字,不需要去看代码细节,就能大体了解相关的逻辑。

再一个,命名要具备语境下的一致性。比如程序员,你不能一会叫coder, 一会叫programmer, 否则别人理解起来就很混乱。

其实,到这儿已经就说完了,是不是感到比预想的要简单。事实也是如此,只要做好模块的拆分,合理的将每段代码写在它该在的位置,开发就没有那么复杂。

原文地址: https://lichuanyang.top/posts/33852/