技术的规范和不规范

yuanoook
yuanoook 发布于 2017-01-09 19:40:48 浏览:1095 类型:原创 - 随笔 分类:类库框架 - 待整理 二维码: 作者原创 版权保护

        鼓励:清晰,高效,方便沟通,开放共享,方便自己和同事(早点下班)。
        避免:杂乱,隐匿信息,封闭,效率低下,拖累自己和同事(加班熬夜)。

        1.命名规范:鼓励具名,避免匿名。
                影响:变量/常量/代码块/闭包/函数/方法/参数/类/接口/命名空间/模块/文件(夹)名

                鼓励长,避免短。
                鼓励全称,避免简写。
                鼓励英文,避免拼音。
                鼓励私有,避免共享。
                鼓励层次,避免散乱。

        2.技术选型:鼓励自由,避免限制。
                影响:平台/软件/语言/工具/三方服务/模块/函数

                鼓励开放,避免封闭。
                鼓励时新,避免过时。
                鼓励单一,欢迎多样。
                鼓励大胆,不要怂。

        3.逻辑模块:鼓励拆分,欢迎合一。

                鼓励依赖清晰,避免依赖不明。
                鼓励职责单一,没有副作用,输出纯粹的。
                避免修改入参,修改依赖,修改上下文,修改全局属性,修改自己,瞎TM修改。

        4.注释文档:鼓励冗余注释,避免口口相传。

                鼓励业务注释,欢迎技术注释。
                鼓励异常注释,欢迎正常注释。

        5.开发工具和开发环境: 鼓励高效,避免低效。

                鼓励自动,避免手动。
                鼓励使用工具,改进工具,创造工具,分享工具。
                鼓励跨平台,避免平台依赖。

        *规范是权衡,不是限制。
标签:
z
给个赞 11 人点赞
收藏 7 人收藏
评论 已有 3 条评论;以下用户言论只代表其个人观点,不代表 前端网(QDFuns) 的观点或立场。
登录 以后才能发表评论
最热评论
老姚
老姚7 天前1F
要多写纯函数,emoticon
举报 支持 (1) 回复 (1)
最新评论
老姚
老姚5 天前3F
百度吧,没有副作用的函数。函数式里的一个常见概念,方便复用和测试的。 //@Rule灬Heng:新手上路  求教    什么是纯函数??? //@老姚:要多写纯函数,emoticon
举报 支持 (0) 回复 (0)
Rule灬Heng
Rule灬Heng5 天前2F
新手上路  求教    什么是纯函数??? //@老姚:要多写纯函数,emoticon
举报 支持 (0) 回复 (1)
老姚
老姚7 天前1F
要多写纯函数,emoticon
举报 支持 (1) 回复 (1)
yuanoook yuanoook 作者

享受平凡 | 追求卓越

作者最新