#407 阿里巴巴 16 条设计规约

2020-07-10
  1. 【强制】存储方案和底层数据结构的设计获得评审一致通过,并沉淀成为文档。
    说明:有缺陷的底层数据结构容易导致系统风险上升,可扩展性下降,重构成本也会因历史数据迁移和系统平滑过渡而陡然增加,所以,存储方案和数据结构需要认真地进行设计和评审,生产环境提交执行后,需要进行 double check。
    正例:评审内容包括存储介质选型、表结构设计能否满足技术方案、存取性能和存储空间能否满足业务发展、表或字段之间的辩证关系、字段名称、字段类型、索引等;数据结构变更(如在原有表中新增字段)也需要进行评审通过后上线。
  2. 【强制】在需求分析阶段,如果与系统交互的 User 超过一类并且相关的 User Case 超过 5 个,使用用例图来表达更加清晰的结构化需求。
  3. 【强制】如果某个业务对象的状态超过 3 个,使用状态图来表达并且明确状态变化的各个触发条件。
    说明:状态图的核心是对象状态,首先明确对象有多少种状态,然后明确两两状态之间是否存在直接转换关系,再明确触发状态转换的条件是什么。
    正例:淘宝订单状态有已下单、待付款、已付款、待发货、已发货、已收货等。比如已下单与已收货这两种状态之间是不可能有直接转换关系的。
  4. 【强制】如果系统中某个功能的调用链路上的涉及对象超过 3 个,使用时序图来表达并且明确各调用环节的输入与输出。
    说明:时序图反映了一系列对象间的交互与协作关系,清晰立体地反映系统的调用纵深链路。
  5. 【强制】如果系统中模型类超过 5 个,并且存在复杂的依赖关系,使用类图来表达并且明确类之间的关系。
    说明:类图像建筑领域的施工图,如果搭平房,可能不需要,但如果建造蚂蚁 Z 空间大楼,肯定需要详细的施工图。
  6. 【强制】如果系统中超过 2 个对象之间存在协作关系,并且需要表示复杂的处理流程,使用活动图来表示。
    说明:活动图是流程图的扩展,增加了能够体现协作关系的对象泳道,支持表示并发等。
  7. 【推荐】需求分析与系统设计在考虑主干功能的同时,需要充分评估异常流程与业务边界。
    反例:用户在淘宝付款过程中,银行扣款成功,发送给用户扣款成功短信,但是支付宝入款时由于断网演练产生异常,淘宝订单页面依然显示未付款,导致用户投诉。
  8. 【推荐】类在设计与实现时要符合单一原则。
    说明:单一原则最易理解却是最难实现的一条规则,随着系统演进,很多时候,忘记了类设计的初衷。
  9. 【推荐】谨慎使用继承的方式来进行扩展,优先使用聚合/组合的方式来实现。
    说明:不得已使用继承的话,必须符合里氏代换原则,此原则说父类能够出现的地方子类一定能够出现,比如,“把钱交出来”,钱的子类美元、欧元、人民币等都可以出现。
  10. 【推荐】系统设计时,根据依赖倒置原则,尽量依赖抽象类与接口,有利于扩展与维护。
    说明:低层次模块依赖于高层次模块的抽象,方便系统间的解耦。
  11. 【推荐】系统设计时,注意对扩展开放,对修改闭合。
    说明:极端情况下,交付的代码都是不可修改的,同一业务域内的需求变化,通过模块或类的扩展来实现。
  12. 【推荐】系统设计阶段,共性业务或公共行为抽取出来公共模块、公共配置、公共类、公共方法等,避免出现重复代码或重复配置的情况。
    说明:随着代码的重复次数不断增加,维护成本指数级上升。
  13. 【推荐】避免如下误解:敏捷开发 = 讲故事 + 编码 + 发布。
    说明:敏捷开发是快速交付迭代可用的系统,省略多余的设计方案,摒弃传统的审批流程,但核心关键点上的必要设计和文档沉淀是需要的。
    反例:某团队为了业务快速发展,敏捷成了产品经理催进度的借口,系统中均是勉强能运行但像面条一样的代码,可维护性和可扩展性极差,一年之后,不得不进行大规模重构,得不偿失。
  14. 【参考】系统设计主要目的是明确需求、理顺逻辑、后期维护,次要目的用于指导编码。
    说明:避免为了设计而设计,系统设计文档有助于后期的系统维护,所以设计结果需要进行分类归档保存。
  15. 【参考】设计的本质就是识别和表达系统难点,找到系统的变化点,并隔离变化点。
    说明:世间众多设计模式目的是相同的,即隔离系统变化点。
  16. 【参考】系统架构设计的目的:
    确定系统边界。确定系统在技术层面上的做与不做。确定系统内模块之间的关系。确定模块之间的依赖关系及模块的宏观输入与输出。确定指导后续设计与演化的原则。使后续的子系统或模块设计在规定的框架内继续演化。确定非功能性需求。非功能性需求是指安全性、可用性、可扩展性等。

#405 Golang 速查表

2020-06-26

1. 环境配置与基础语法

  • 目标:搭建开发环境,掌握基本语法和编程逻辑。
  • 内容:
    • 安装 Go 版本(推荐 Go 1.21+)及 IDE(如 VS Code + Go 插件、IntelliJ IDEA)。
    • 变量与数据类型(整型、浮点型、布尔型、字符串、数组、切片、字典)。
    • 运算符(算术、关系、逻辑、位运算)。
    • 流程控制(if-elseforswitchgoto)。
    • 函数与方法(函数定义、参数传递、返回值、闭包)。
  • 练习:
    • 编写计算器、斐波那契数列生成器。
    • 实现一个简易的 Todo List 管理工具。

2. 面向对象与结构体

  • 目标:理解 Golang 的 OOP 模型。
  • 内容:
    • 结构体(struct)的定义与初始化。
    • 方法(Method)的绑定(值接收者 vs 指针接收者)。
    • 接口(interface)与类型断言。
    • 组合(Composition)代替继承。
  • 练习:
    • 设计一个动物 kingdom,包含不同动物的行为(如 Dog 吠叫、Bird 飞翔)。
    • 实现一个简单的电商商品库存管理系统。

3. 并发与 Goroutine

  • 目标:掌握 Golang 的并发编程模型。
  • 内容:
    • Goroutine 的启动与停止(go func())。
    • Channel 的使用(阻塞、非阻塞、缓冲区)。
    • select 语句实现多路复用。
    • sync.Mutexatomic 包(锁与原子操作)。
  • 练习:
    • 实现一个多线程的 Web 服务器,处理并发请求。
    • 模拟生产者-消费者问题,使用 Channel 通信。

4. 标准库实战

  • 目标:熟悉 Golang 核心库,快速开发实际应用。
  • 内容:
    • 网络编程:net/http(REST API)、net/url(URL 解析)。
    • 数据处理:encoding/json/xml(序列化/反序列化)、sort/math(常用算法)。
    • 文件 I/O:os/path/filepath(文件操作)、io/ioutil(批量读写)。
    • 模板引擎:html/template(生成动态 HTML)。
  • 项目:
    • 构建一个 RESTful API(用户管理、文章发布)。
    • 开发一个命令行工具(如文件压缩/解压、天气查询)。

5. 微服务与框架

  • 目标:掌握企业级开发模式与流行框架。
  • 内容:
    • 微服务架构(服务拆分、API 网关、配置中心)。
    • 使用框架:Gin(轻量级 HTTP 框架)、EchoBeego
    • 分布式工具:etcd(键值存储)、Consul(服务发现)。
    • 容器化与 Docker(部署 Go 应用)。
  • 项目:
    • 设计一个电商系统,包含用户服务、订单服务、支付服务。
    • 实现一个实时聊天室(WebSocket + Goroutine)。

6. 数据库与 ORM

  • 目标:连接数据库并高效操作。
  • 内容:
    • SQL 数据库驱动(database/sql + PostgreSQL/MySQL)。
    • ORM 工具:GORMsqlx
    • NoSQL 支持(MongoDB + mgo 包)。
  • 项目:
    • 开发一个博客系统(支持 MySQL 存储、标签分类)。
    • 实现一个用户登录注册系统(JWT 认证 + Redis 会话)。

7. 工程化实践

8. 性能与调优

  • 目标:提升代码性能与稳定性。
  • 内容:
    • 性能分析工具:pproftrace
    • 优化技巧:减少内存分配、利用缓存、并发优化。
    • 错误处理与日志(log 包、zap 日志库)。
  • 实战:
    • 分析高并发场景下的性能瓶颈(如百万级请求处理)。
    • 重构代码,优化响应时间与资源占用。

#402 Linux 查看文件打开情况

2020-06-23

查看这个进程打开了哪写文件

-> % ps -ef | grep rsyslogd | grep -Fv grep
syslog      1068       1  0 1月06 ?       00:00:03 /usr/sbin/rsyslogd -n -iNONE

-> % sudo ls -l /proc/1068/fd 
总计 0
lr-x------ 1 root root 64  1月  8 16:54 0 -> /dev/null
l-wx------ 1 root root 64  1月  8 16:54 1 -> /dev/null
l-wx------ 1 root root 64  1月  8 16:54 10 -> /var/log/kern.log
l-wx------ 1 root root 64  1月  8 16:54 11 -> /var/log/auth.log
l-wx------ 1 root root 64  1月  8 16:54 2 -> /dev/null
lrwx------ 1 root root 64  1月  6 09:46 3 -> 'socket:[13299]'
lr-x------ 1 root root 64  1月  8 16:54 4 -> /dev/urandom
lrwx------ 1 root root 64  1月  8 16:54 5 -> 'socket:[27825]'
lrwx------ 1 root root 64  1月  8 16:54 6 -> 'socket:[27831]'
lr-x------ 1 root root 64  1月  8 16:54 7 -> /proc/kmsg
lrwx------ 1 root root 64  1月  8 16:54 8 -> 'socket:[22468]'
l-wx------ 1 root root 64  1月  8 16:54 9 -> /var/log/syslog

查看哪些进程打开了这个文件

-> % sudo find /proc/*/fd -ls | grep /var/log/syslog
  2551982      0 l-wx------   1 root             root                   64 1月  8 16:50 /proc/1068/fd/9 -> /var/log/syslog

-> % ps -fq 1068   
UID          PID    PPID  C STIME TTY          TIME CMD
syslog      1068       1  0 1月06 ?       00:00:03 /usr/sbin/rsyslogd -n -iNONE

#401 uu 编码(Unix-to-Unix Encode)

2020-06-21

uu 编码是加州大学伯克利分校 1980 年为在邮件中传输二进制文件而设计的一种 B2T(Binary-To-Text)/ B2A(Binary-To-Ascii)编码。
九十年代,MIME 被设计出来并成为国际标准之后,uu 编码就正式退出了历史舞台。
uu 代表 Unix-to-Unix Copy,表示将一个文件从一个 Unix 系统传输到另一个 Unix 系统。

#400 在 Git 历史记录中搜索

2020-06-12

搜索提交信息

git log --grep=fix: --oneline --after='2018-07-01' --author=markjour

搜索历史文件

git grep -C3 sign_position $(git rev-list --all)

搜索 diff 内容

git log -G'前置'
git log -G'前置' -p | grep '前置' -C5
git log -G'前置' --oneline --name-status

-S<string> --pickaxe-regex-G<regex> 作用相近,
不过 -S 只会列出搜索内容增删的相关信息,也就是所在行修改了,但是搜索内容没有变化的会忽略

#399 wttrin 终端看天气

2020-06-07

https://github.com/chubin/wttr.in
stars license lang repoSize commitFreq

curl wttr.in/wuhan
curl wttr.in/wuhan?lang=zh
curl wttr.in/jiangxia?lang=zh

# 指定日期
curl wttr.in/jiangxia@2020-06-07?lang=zh
View options:
    0                       # only current weather
    1                       # current weather + today's forecast
    2                       # current weather + today's + tomorrow's forecast
    A                       # ignore User-Agent and force ANSI output format (terminal)
    F                       # do not show the "Follow" line
    n                       # narrow version (only day and night)
    q                       # quiet version (no "Weather report" text)
    Q                       # superquiet version (no "Weather report", no city name)
    T                       # switch terminal sequences off (no colors)

指定 view:

# 只看今天的天气
# 不显示颜色
curl "wttr.in/jiangxia?0T&lang=zh"

#398 Python GUI 开发框架

2020-05-29
  • Tkinter 可以认为是 Python 官方支持的 GUI 框架,接近标准库的地位,样式风格就是极简。
    基于 Tcl/Tk。

  • PyQt Riverbank Computing 提供的第三方 Python 绑定,非常知名。
    风险:GPL 协议,并不是和 Qt 一样的 LGPL。也就是说,使用 PyQt 开发的软件必须开源,除非购买商业授权。特别不建议使用
    没有看到 GitHub 仓库。

  • PySide Qt 官方 Python 绑定,也叫 Qt for Python。
    据说当年 Qt 的持有者,Nokia 公司,找 Riverbank Computing 谈 PyQt 的授权问题,没有谈成,因而从新开发了这个项目。
    没有 GitHub 仓库,代码可以在 官方 cgit 上看到。
    注意:这里就指 pyside2,和更老的 pyside 区分开来。

  • PyGObject GTK 官方 Python 绑定
    原来叫 PyGTK,多好,不知道为什么改成这个名字
    https://gitlab.gnome.org/GNOME/pygobject
    https://github.com/GNOME/pygobject

  • kivy

  • wxPython https://github.com/wxWidgets/Phoenix

  • PySimpleGUI

  • DearPyGui
  • pywebview

  • beeware/toga

  • python-eel/Eel
  • flexxui/flexx 基于 Web 技术

gooey 可以快速实现命令行 GUI 化。