写给自己看的软件开发准则

本文最后更新于:1 天前

太纠结细节也不好

整理自 Flomo 标签:#Development/软件开发习惯

1. 总则篇:

不要尽善尽美

做界面、做接口时,优先考虑正常使用情况和场景,保证基本功能实现。

关于在写代码的思维活跃过程中,灵光一现想出来的要针对非正常情况、异常情况的处理,应在软件基本功能完成之后,根据实际情况是否会发生、影响范围以及影响程度来评估是否需要进行相应的优化处理。


2. 技术篇:

接口开发尽量或者全部用 POST 请求,GET 请求容易在链接中暴露参数,很不安全。

起因是有些服务在运营阶段,是会有第三方责任/监管单位进行漏洞扫描的,经目前的经历总结来看,被扫出来的漏洞,多数都发生在 GET 请求上。

虽然现在 https 是标配了,但在部分测试场景下,还是不排除会有疏漏导致 http 接口暴露在互联网。


3. Web前端优化篇:

1 数据显示:

  • 手机号、身份证号等隐私字段,需结合实际场景判断是否需要脱敏显示
  • 页面上显示当前登录账号的昵称,例如:欢迎您使用XX系统,XX先生。
  • 页面欢迎语显示当前时间

2 表格类页面:

  • 表格表头:关注度较高的字段信息排在前面
  • 横向滚动:表头过多的情况下,支持横向滚动
  • 搜索条件:搜索字段与表格表头的内容和顺序 一 一对应
  • 表格单元格:

2.1 表格单元格:

  • 状态类字段最好以 tag 的形式显示,并加以颜色区分;

  • 可点击文字以 link 的形式显示;

  • 数量、金额等字段类型加上单位显示,其中金额能加上千分符最好


3 弹窗:

  • 标题尽可能显示当前弹窗预览的主题,不要只显示诸如 “详情” “预览” 等简要字样
  • 如果弹窗所显示的业务实体可能会在多个页面多次预览,那么请将弹窗进行组件化封装

4 表单类页面:

  • a
  • b

5 大屏类

  • 动态时间显示

逐步记录……


写给自己看的软件开发准则
https://blog.doracoin.cc/posts/development/16695.html
作者
Doracoin
发布于
2025年9月11日
更新于
2025年9月15日
许可协议