ESP8266开发之旅 进阶篇⑤ 代码规范 —— 像写文章一样优美

本文介绍了ESP8266开发中的代码规范,包括文件命名、注释、常量、变量的规范,以及函数方法的注释、拆分和参数管理,强调了代码规范在团队协作、项目扩展和自我理解中的重要性。通过实例展示了如何提高代码可读性和可维护性。

授人以鱼不如授人以渔,目的不是为了教会你具体项目开发,而是学会学习的能力。希望大家分享给你周边需要的朋友或者同学,说不定大神成长之路有博哥的奠基石。。。

快速导航
单片机菜鸟的博客快速索引(快速找到你要的)

如果觉得有用,麻烦点赞收藏,您的支持是博主创作的动力。

1.前言

    之前,一直在跟大伙分享怎么去玩蓝牙模块,怎么去玩wifi模块,怎么去玩json,然后有很多小伙伴就留言各种问题或者说直接怼他的代码过来让我看,然后我就一脸懵逼(代码中到处各种abcd变量,各种一个方法几百行,也没有什么注释,我心中一万只万马奔腾)。所以就有了这次的主题,代码规范(当然,这是我自己的代码规范经验,只是借鉴经验),教了大家怎么去做东西,反而忽略了最基本的东西。
    特别是出来工作之后,我就觉得代码规范比做需求业务还要重要。
    首先,方便他人。一个项目往往是由多人一起完成的,代码规范,会让大家交流起来更加简单有效,别人接手你的代码也比较容易。
    其次,方便扩展。一个好的项目,代码还是得具有一定的扩展性,很多时候项目是迭代开发的,分层抽象还是很重要。
    最后,方便自己。很多开发人员都会有这种感觉,自己写的代码,过一段时间回来再看的时候,就会有点懵逼的感觉(往往就是因为代码不够规范,也没什么注释,连自己都看不懂了)。
    这次计划分三篇来分享,尽量概括常见的规范点,主题分为三部分:

  • 工程代码规范
  • 函数方法规范
  • 兼容性规范

2.工程代码规范

    工程代码规范,主要是针对整个项目来规范。

2.1 文件命名

2.1.1 错误写法
  • 博主还记得大学的时候非常喜欢用abcdxy这些单一的字母来命名文件,隔一段时间再去
评论 5
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

单片机菜鸟哥

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值