关于写程序的一个经验

最近有一些感触。

我从外企出来以后,分别进入过两家民企,接触过两个游戏项目,也算是大项目。

虽然两个项目的技术层次不一样,但有一个症结都很雷同,我相信也是大部分项目都有的问题。

就是,今天修好了这个bug,那边又冒起来一个,像打地鼠一样,根本就修不完。就算是修到基本稳定,也是千疮百孔,四处补丁。


我认为,导致这种问题的最根本原因是,程序员没有遵照:一个模块只做一件事情  的基本原则。这里的模块可以指一个函数(我认为函数是最基本的逻辑单元),也可以是一个大逻辑模块。


因为之前在外企受过良好的影响,我非常注重这一个问题,如果说写代码花1小时,那么我至少花了三个小时来规划架构和反复的重构接口,务必让每个模块,每个参数绝对没有二义性,也没有矛盾冲突。

实践证明,我写过的模块,复杂度再高,也很稳定,基本不会反反复复出bug,以至于到项目后期我都挺寂寞的,呵呵。

其实模块稳定只是一个最基本最基本的要求,这个原则的更大的优点是:扩展性相当的好。因为每个函数的含义都唯一,所以只要模块逻辑本身没有问题,都可以很纯粹的通过重组来实现。经常听到程序员抱怨需求变化让他大改大修,其实这是典型的一个没有把问题进行抽象分解导致的问题。很多时候,我们不应该仅仅只看需求表面的文字,而应该通过表面看到这个问题的实质,针对这个实质提出解决方案,就算他表面再怎么变,也就是重组一下结构,增加一些接口而已。

如果一个函数不纯粹,或者模块内部彼此错综复杂理不顺,这里if那里if的,这种模块就相当脆弱,更别指望它的性能。

通常表现就是:代码冗余,if语句遍地都是,函数爆长,参数暴多,到处都是潜规则。每次看到这种代码我就一阵头疼。那不是在和计算机斗争,那是在和一个精神分裂逻辑混乱的患者尝试交流。


还有一些人对扩展性的理解就是,对函数加一票参数,然后告诉你这个参数改一改可以这样,那个参数改一改可以那样,反正是一串,十多个。这种理解实在太病态了。每次遇到这种接口(特别是原作者已经不在),都忍不住找个墙来撞。


我以为,对于一个bug,程序员在30分钟以内,找到原因,在一个小时内修好,并保证这个模块永远不再出现类似的bug,就是优秀的。

如果掌握了这个原则,其实是很容易达成这一点的。





AI 代码审查Review工具 是一个旨在自动化代码审查流程的工具。它通过集成版本控制系统(如 GitHub 和 GitLab)的 Webhook,利用大型语言模型(LLM)对代码变更进行分析,并将审查意见反馈到相应的 Pull Request 或 Merge Request 中。此外,它还支持将审查结果通知到企业微信等通讯工具。 一个基于 LLM 的自动化代码审查助手。通过 GitHub/GitLab Webhook 监听 PR/MR 变更,调用 AI 分析代码,并将审查意见自动评论到 PR/MR,同时支持多种通知渠道。 主要功能 多平台支持: 集成 GitHub 和 GitLab Webhook,监听 Pull Request / Merge Request 事件。 智能审查模式: 详细审查 (/github_webhook, /gitlab_webhook): AI 对每个变更文件进行分析,旨在找出具体问题。审查意见会以结构化的形式(例如,定位到特定代码行、问题分类、严重程度、分析和建议)逐条评论到 PR/MR。AI 模型会输出 JSON 格式的分析结果,系统再将其转换为多条独立的评论。 通用审查 (/github_webhook_general, /gitlab_webhook_general): AI 对每个变更文件进行整体性分析,并为每个文件生成一个 Markdown 格式的总结性评论。 自动化流程: 自动将 AI 审查意见(详细模式下为多条,通用模式下为每个文件一条)发布到 PR/MR。 在所有文件审查完毕后,自动在 PR/MR 中发布一条总结性评论。 即便 AI 未发现任何值得报告的问题,也会发布相应的友好提示和总结评论。 异步处理审查任务,快速响应 Webhook。 通过 Redis 防止对同一 Commit 的重复审查。 灵活配置: 通过环境变量设置基
【直流微电网】径向直流微电网的状态空间建模与线性化:一种耦合DC-DC变换器状态空间平均模型的方法 (Matlab代码实现)内容概要:本文介绍了径向直流微电网的状态空间建模与线性化方法,重点提出了一种基于耦合DC-DC变换器的状态空间平均模型的建模策略。该方法通过数学建模手段对直流微电网系统进行精确的状态空间描述,并对其进行线性化处理,以便于系统稳定性分析与控制器设计。文中结合Matlab代码实现,展示了建模与仿真过程,有助于研究人员理解和复现相关技术,推动直流微电网系统的动态性能研究与工程应用。; 适合人群:具备电力电子、电力系统或自动化等相关背景,熟悉Matlab/Simulink仿真工具,从事新能源、微电网或智能电网研究的研究生、科研人员及工程技术人员。; 使用场景及目标:①掌握直流微电网的动态建模方法;②学习DC-DC变换器在耦合条件下的状态空间平均建模技巧;③实现系统的线性化分析并支持后续控制器设计(如电压稳定控制、功率分配等);④为科研论文撰、项目仿真验证提供技术支持与代码参考。; 阅读建议:建议读者结合Matlab代码逐步实践建模流程,重点关注状态变量选取、平均化处理和线性化推导过程,同时可扩展应用于更复杂的直流微电网拓扑结构中,提升系统分析与设计能力。
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值