主题对照

用类型与框架保障代码正确性

比较借助类型系统、安全库、编译器与语言选择把错误挡在编码阶段的方法。

27 张卡片 · 9 本书

本层 27 张卡片 · 含下级覆盖 27 张卡片

本主题的卡片

Google系统架构解密:构建安全可靠的系统 · 设计中的权衡

内置安全可靠的框架是双赢

Google 内部 Web 框架让开发者省去常见配置和部署杂务,同时通过一致性检查、组件隔离、监控和健康检查提供安全可靠能力。这些能力是框架团队与 SRE、安全团队在设计和实施阶段刻意融入的,并非偶然副产品。默认安全的工具路径可降低犯错机会,与规范和培训相互补充;开发便利与系统安全因而可以同时提高。

查看卡片与原书出处

Google系统架构解密:构建安全可靠的系统 · 面向易理解性的设计

安全需求集中实现减少审查表面积

每个服务自行拼装身份认证、授权和审计等横切能力,容易漏配授权策略。应用程序框架可确保每个服务有有效策略,并默认拒绝未明确允许的客户端,从而减少重复实现的审查负担。但审查仍须核对框架默认行为、各服务的授权配置和业务逻辑;集中实现不能让审查量只由框架数量决定。参见[[内置安全可靠的框架是双赢]]。

查看卡片与原书出处

Google系统架构解密:构建安全可靠的系统 · 面向易理解性的设计

类型系统把校验逻辑收进构造函数

处理 URL 或拼接 SQL 的代码若依赖调用者自行校验,审查就要追溯所有输入路径。可把“已校验 URL”或“可安全拼接的 SQL 字符串”设计成独立类型,仅由构造函数校验后创建。下游只接受该类型,安全不变量主要在构造处核对;这以代码不能绕过类型约束为前提,并不免除对其他业务逻辑的审查。

查看卡片与原书出处

Google系统架构解密:构建安全可靠的系统 · 面向易理解性的设计

安全库防不了设计层面的错误

Tink 等安全库可防止 GCM 随机数重用等实现错误,却不能替开发者判断设计是否适用。对信用卡号等取值空间有限的数据直接哈希,结果仍可能被枚举;应按数据特性选择合适的保护方式。审查时既要核对是否使用可靠的库,也要核对所选机制能否覆盖当前威胁。

查看卡片与原书出处

Google系统架构解密:构建安全可靠的系统 · 案例分析:设计、实现和维护一个受信任的公共CA

按输入信任程度选择编程语言

直接解析互联网证书签名请求等不可信输入的模块可优先使用 Go 等内存安全语言,减少内存类漏洞。必须使用 C++ 的组件,则配合 W^X、Scudo、SafeStack 等防护;还可让不同实现分别解析请求并比较结果。语言与缓解措施应随输入信任程度和基础设施约束选择。

查看卡片与原书出处

Google系统架构解密:构建安全可靠的系统 · 案例分析:设计、实现和维护一个受信任的公共CA

只实现需要的功能子集能降低审计成本

现成 CA 软件支持大量不需要的证书属性和扩展字段,每种多余功能都会增加审计与故障面。只实现面向 Web 服务的实际证书用例,可让系统更易理解、验证和维护。实现标准时应从真实需求确定功能子集,而非把规范中的所有可选能力都视为必须支持。

查看卡片与原书出处

Google系统架构解密:构建安全可靠的系统 · 编写代码

编译器报错比代码审查反馈更省成本

同样是发现”这段代码使用了不安全的API”,编译器当场报错和提交审查时才被指出,修复成本天差地别——审查时代码已写完并能跑,这时才被要求重构会让开发者沮丧;编译期报错时开发者对上下文记忆最新鲜,能快速处理。这提示把安全检查往左移到编译期(用类型系统或Error Prone、Tsetse这类插件强制),比依赖事后人工审查更有效,是反馈时机决定了修复的心理成本和质量。

查看卡片与原书出处

Google系统架构解密:构建安全可靠的系统 · 编写代码

给不安全API判类型实现渐进式退场

给历史遗留的不安全函数(如接受裸字符串的SQL查询接口)新增一个只接受安全类型参数的重载版本,给存量调用点标注注解,再引入Git hooks阻止增量代码继续使用字符串类型重载,或用可见性白名单限制不安全API只能经安全团队审批调用。存量不安全调用被冻结不再增长,新代码被迫走安全路径。随项目活跃开发,安全调用比例会自然向安全API收拢,直到旧调用少到可人工清理,代码从设计机制上彻底摆脱这类漏洞。

查看卡片与原书出处

Google系统架构解密:构建安全可靠的系统 · 编写代码

安全库故意只覆盖常见场景

想做一个能应对所有场景的安全库(比如处理HTML单引号、JS作用域、HTML属性三层嵌套上下文的模板引擎)往往极其复杂,难以正确使用。更实际的策略是反过来:先做一个只覆盖最常见场景、简单到易于解释和正确使用的小库,帮助说服其他人采纳”默认安全”的函数库;不同场景(复杂页面模板与短代码片段)再提供不同库。这是用真实使用频率反向驱动库的复杂度增长,而非一开始追求大而全。

查看卡片与原书出处

Google系统架构解密:构建安全可靠的系统 · 编写代码

YAGNI代码带来的是没人测试的路径

为“以防万一”预先实现的分支增加文档、测试和维护负担,也常因缺少真实调用场景而未被充分验证。一旦意外触发,可能暴露安全或可靠性缺陷。YAGNI 原则要求只实现当前需要的功能;减少未使用路径,既节省维护成本,也缩小待审查和测试的行为范围。

查看卡片与原书出处

Google系统架构解密:构建安全可靠的系统 · 编写代码

强类型防止代价高昂的单位混淆

普通数字无法让编译器区分秒与分钟、磅与千克;单位混淆可能造成严重后果。把时长、重量等量封装为带单位的强类型,只允许有意义的运算,并明确进行单位换算,可在编译或构造阶段发现错误,避免让无单位数字跨接口传播。

查看卡片与原书出处

Google系统架构解密:构建安全可靠的系统 · 编写代码

RPC上下文承载身份与时限

RPC 框架可把鉴权拦截器验证过的调用方信息放进请求上下文,让下游拦截器使用同一份可信身份;上下文还追踪请求执行时间,发生明显超时时自动取消后续工作并尽快通知客户端。身份和时限随请求传递,能减少各层重复验证或继续处理已无效请求。

查看卡片与原书出处

Google系统架构解密:构建安全可靠的系统 · 编写代码

遗留豁免集中后再删除

迁移大量接受裸字符串的遗留 API 时,可把“任意字符串→安全类型”的临时豁免集中到一个转换函数,先让调用点改用受类型约束的新 API。集中入口便于审查和统计剩余依赖,但它本身不证明输入安全;存量迁完后必须删除该入口,才能真正关闭绕过路径。这补充了[[给不安全API判类型实现渐进式退场]]的收尾步骤。

查看卡片与原书出处

Go语言底层原理剖析 · 常量与隐式类型转换

隐式转换很窄

Go 的隐式转换主要服务常量,而不是让变量之间自由互转。这样避免了 C 系语言常见的静默截断和符号错误;发散:少一点便利,换来更少隐藏 bug。

查看卡片与原书出处

Go语言底层原理剖析 · 数组

越界可提前发现

数组长度是类型的一部分,编译器能在部分场景提前发现越界或优化边界检查。固定形状的数据结构让编译期掌握更多事实,也给运行时少留一点不确定性。

查看卡片与原书出处

JavaScript语言精粹(修订版) · JSLint

Lint是外部约束

JSLint 是一个 JavaScript 代码质量工具,扫描源文本并对发现的问题给出描述和大致位置;被发现的问题多是语法错误,但也包括代码风格惯例和结构上的问题。它”不会证明你的程序是否正确,只是提供了另一种视角帮助你辨认问题”——静态检查工具的定位是发现高风险信号,而不是给出正确性证明。发散:工具的价值不是替代思考,而是把重复性警觉自动化,让人把注意力留给工具无法判断的语义问题。

查看卡片与原书出处

JavaScript语言精粹(修订版) · JSLint

子集需要执行器

JSLint 定义了比当时 ECMAScript 第3版更严格的 JS 子集,与第9章代码风格密切相关;检查未声明变量、危险特性和代码块等约定,把“更好子集”从文字建议变成自动化规则。具体 JSLint 选项随版本变化,原则是用工具持续执行团队选定的规则。关联:[[好语言可取子集]];发散:工具能稳定提醒,但取舍仍需解释业务语义。

查看卡片与原书出处

企业应用架构模式

隐含锁只自动化读锁

加锁模式最怕有人漏写加锁代码,而离线并发问题极难测试。隐含锁把不能跳过的加锁动作下沉到框架、层超类型或代码生成中。应自动化的是乐观锁的版本存储、检查与递增,以及悲观锁中为读取获取锁、事务结束释放所有锁;唯独为编辑获取写锁不该自动化:否则写锁失效时用户无从提前知道、无法尽早止损,并发度也被压到最低。框架只需在提交前检查写锁是否已显式获取,没有就抛出并发异常,而不是依赖可能被关闭的断言。

查看卡片与原书出处

你真的会写代码吗-2021 · 请重复利用:可复用性

擦除限制泛型

Java泛型以类型擦除实现通用实例,不能把T直接当成运行时可具体化的类来 new T()、new T[] 或 instanceof T。擦除不表示类文件里完全没有泛型签名元数据。发散:泛型提升编译期表达力,但运行期能力仍受语言实现策略约束。

Java虚拟机规范的Signature属性说明泛型声明可保存为签名元数据;这与运行时不能直接实例化类型变量并不矛盾。

查看卡片与原书出处

恰如其分的软件架构 · 概述

约束提升代码可推理性

给抽象概念主动施加约束,反而能增强对系统的推理能力,而不是限制自由。例如把”作业”限定为无副作用,就更容易推理同一作业的重复运行及多个作业的并行执行,减少作业通过共享副作用彼此干扰;无副作用本身并不保证进程或集群绝不故障;反之,对随意编写、没有约束的代码块,开发者很难判断它”不会做什么”,因为缺乏约束意味着无法排除任何可能性。发散:这解释了为什么类型系统、不可变数据结构、纯函数这类”限制自由”的设计,长期看反而降低了系统的认知负担。

查看卡片与原书出处

恰如其分的软件架构 · 结论

引入约束的四步流程

约束像导轨,限制不希望出现的设计,使质量目标更易分析;它同时排除了其他人可能提出的方案,因此要说明收益和代价。

  1. 先考虑尚未增加这条约束的情况。
  2. 明确系统的交互、安全或性能目标。
  3. 追问目标可能怎样失败、约束是否能帮助、是否难用以及有哪些权衡。
  4. 决定是否引入约束或选择既有风格,并检查所依赖的保证。

“从无约束开始”是思考新增约束的基线,不是移除既有安全要求的操作建议。原书Android权限案例是历史说明,不作为当前平台授权机制的描述。

查看卡片与原书出处

架构之美 · 记忆留存(Michael Nygard)

不可修改与复制防联动

设计和构图会被嵌套,之后还可能出新版本或被删掉。如果订单只保存引用,新版本会改到旧订单,删除则会留下悬空引用。

两条规则一起用:创建之后不再修改;选用时复制完整副本,不保留引用。从复制那一刻起,新旧构图互不影响,订单里的描述也带上完整副本。

图像文件太大,是唯一不复制的东西。每张图分配一个 GUID,也就是全局唯一标识;一旦分配,这张图就不再修改。订单只收集这些标识,把对应文件放进 DVD。

查看卡片与原书出处

Go语言底层原理剖析 · 常量与隐式类型转换

常量转换须可表示

无类型常量能按赋值目标隐式获得整数或浮点类型,但必须满足目标类型的可表示性规则:整数目标不能截去小数部分;浮点目标允许按其精度舍入。它是 [[隐式转换很窄]] 的具体边界;检查赋值错误时,要区分整数截断与浮点舍入。

查看卡片与原书出处

Effective Go中文版 · 数据

零值可用能组合传递

类型若把零值设计为有效状态,调用者就可直接声明变量而不必调用构造器。bytes.Buffer 的零值是空缓冲,sync.Mutex 的零值是未锁定状态;把二者放进结构体后,外层结构体也能继承这种开箱即用的性质。设计类型时考虑零值,可减少初始化步骤。

查看卡片与原书出处

Effective Go中文版 · 空白标识符

空白赋值强制检查接口实现

若接口使用只在运行时发生,编译器可能没有机会检查某个类型是否具备预期方法。包内可写 var _ json.Marshaler = (*RawMessage)(nil)。(*RawMessage)(nil) 是一个空指针,不分配对象;把它赋给接口,只为了让编译器确认 *RawMessage 实现了 Marshaler。接口以后改了,这一行会编译失败。_ 表明这里只要检查、不保留变量。已有静态使用能完成检查时,不必重复声明。

查看卡片与原书出处

基于Kotlin的Spring Boot微服务实战 · Kotlin的语法

空安全前置

Kotlin 把可空性放进类型系统,让“可能为 null”在编译期暴露,而不是等运行时抛异常。可空类型、非空类型和安全调用把空值处理从隐性约定变成显性契约。发散:越早暴露约束,越少依赖测试和运气兜底。

查看卡片与原书出处

基于Kotlin的Spring Boot微服务实战 · Kotlin的语法

密封类限状态

密封类用有限子类表达受限继承结构,适合建模“状态只有这几种”的业务结果。调用方处理分支时能围绕已知状态展开,减少遗漏未知类型的风险。发散:比起散落的字符串状态码,密封类让状态空间更接近领域模型。

查看卡片与原书出处
辅助阅读:卢曼编号

按卢曼编号阅读

点击箭头逐层展开,点击卡片标题查看详情。路径上下文仅用于连接层级,不计入主题卡片数。

  • 展开或收起下级: 465 Go 的编译-执行-开发效率三角平衡 路径上下文 Go入门指南 · 1.2 语言的主要特性与发展的环境和影响因素 理解等级:未标注
  • 展开或收起下级: 470 Flag解析命令参数 路径上下文 Go语言入门到实战(共3册) · Go语言编程之旅:第1章 命令行应用:打造属于自己的工具集 理解等级:未标注
    • 展开或收起下级: 470.b Gin的路由取舍 路径上下文 Go语言入门到实战(共3册) · Go语言编程之旅:第2章 HTTP应用:写一个完整的博客后端 理解等级:未标注
      • 展开或收起下级: 470.b.1 中间件是请求管道 路径上下文 Go语言入门到实战(共3册) · Go语言编程之旅:第2章 HTTP应用:写一个完整的博客后端 理解等级:未标注
        • 展开或收起下级: 470.b.1.a 追踪串起请求因果 路径上下文 Go语言入门到实战(共3册) · Go语言编程之旅:第2章 HTTP应用:写一个完整的博客后端 理解等级:未标注
          • 展开或收起下级: 470.b.1.a.1 IDL稳定RPC契约 路径上下文 Go语言入门到实战(共3册) · Go语言编程之旅:第3章 RPC应用:启动你的RPC服务 理解等级:未标注
            • 展开或收起下级: 470.b.1.a.1.c Metadata承载上下文 路径上下文 Go语言入门到实战(共3册) · Go语言编程之旅:第3章 RPC应用:启动你的RPC服务 理解等级:未标注
              • 展开或收起下级: 470.b.1.a.1.c.3 Pprof面向采样诊断 路径上下文 Go语言入门到实战(共3册) · Go语言编程之旅:第6章 Go语言中的大杀器 理解等级:未标注
                • 展开或收起下级: 470.b.1.a.1.c.3.a Trace观察调度过程 路径上下文 Go语言入门到实战(共3册) · Go语言编程之旅:第6章 Go语言中的大杀器 理解等级:未标注
                  • 展开或收起下级: 470.b.1.a.1.c.3.a.6 整型宽度影响移植 路径上下文 Go语言入门到实战(共3册) · Go语言编程入门与实战技巧:第3章 基础数据类型 理解等级:未标注
                    • 展开或收起下级: 470.b.1.a.1.c.3.a.6.a 浮点比较要避等号 路径上下文 Go语言入门到实战(共3册) · Go语言编程入门与实战技巧:第3章 基础数据类型 理解等级:未标注
                      • 展开或收起下级: 470.b.1.a.1.c.3.a.6.a.2 函数是复用单元 路径上下文 Go语言入门到实战(共3册) · Go语言编程入门与实战技巧:第5章 函数 理解等级:未标注
                        • 展开或收起下级: 470.b.1.a.1.c.3.a.6.a.2.d 函数是最小模块 路径上下文 Go语言入门到实战(共3册) · Go语言学习笔记:第4章 函数 理解等级:未标注
                          • 展开或收起下级: 470.b.1.a.1.c.3.a.6.a.2.d.1 多返回值直面错误 路径上下文 Go语言入门到实战(共3册) · Go语言学习笔记:第4章 函数 理解等级:未标注
                            • 展开或收起下级: 470.b.1.a.1.c.3.a.6.a.2.d.1.a Defer注册退出动作 路径上下文 Go语言入门到实战(共3册) · Go语言学习笔记:第4章 函数 理解等级:未标注
                              • 展开或收起下级: 470.b.1.a.1.c.3.a.6.a.2.d.1.a.1 错误处理偏显式 路径上下文 Go语言入门到实战(共3册) · Go语言学习笔记:第4章 函数 理解等级:未标注
                                • 展开或收起下级: 470.b.1.a.1.c.3.a.6.a.2.d.1.a.1.a 字符串是字节序列 路径上下文 Go语言入门到实战(共3册) · Go语言学习笔记:第5章 数据 理解等级:未标注
                                  • 展开或收起下级: 470.b.1.a.1.c.3.a.6.a.2.d.1.a.1.a.1 子串可能保留底层 路径上下文 Go语言入门到实战(共3册) · Go语言学习笔记:第5章 数据 理解等级:未标注
                                    • 展开或收起下级: 470.b.1.a.1.c.3.a.6.a.2.d.1.a.1.a.1.a 数组复制成本明确 路径上下文 Go语言入门到实战(共3册) · Go语言学习笔记:第5章 数据 理解等级:未标注
                                      • 展开或收起下级: 470.b.1.a.1.c.3.a.6.a.2.d.1.a.1.a.1.a.3 方法集决定接口实现 路径上下文 Go语言入门到实战(共3册) · Go语言学习笔记:第6章 方法 理解等级:未标注
  • 展开或收起下级: 1449 安全可靠性是系统涌现特性 路径上下文 Google系统架构解密:构建安全可靠的系统 · 设计中的权衡 理解等级:未标注
  • 展开或收起下级: 1451 不变量是全称命题不是抽样保证 路径上下文 Google系统架构解密:构建安全可靠的系统 · 面向易理解性的设计 理解等级:未标注
  • 展开或收起下级: 1456 自建基础设施看三个信号 路径上下文 Google系统架构解密:构建安全可靠的系统 · 案例分析:设计、实现和维护一个受信任的公共CA 理解等级:未标注
  • 展开或收起下级: 1457 编译器报错比代码审查反馈更省成本 主题成员 Google系统架构解密:构建安全可靠的系统 · 编写代码 理解等级:未标注
  • 展开或收起下级: 1470 无类型常量 路径上下文 Go语言底层原理剖析 · 常量与隐式类型转换 理解等级:未标注
    • 展开或收起下级: 1470.a 隐式转换很窄 主题成员 Go语言底层原理剖析 · 常量与隐式类型转换 理解等级:未标注
      • 1470.a.1 常量转换须可表示 主题成员 Go语言底层原理剖析 · 常量与隐式类型转换 理解等级:中级
  • 展开或收起下级: 1472 数组是值 路径上下文 Go语言底层原理剖析 · 数组 理解等级:未标注
    • 1472.a 越界可提前发现 主题成员 Go语言底层原理剖析 · 数组 理解等级:未标注
  • 展开或收起下级: 1500 Lint是外部约束 主题成员 JavaScript语言精粹(修订版) · JSLint 理解等级:未标注
    • 1500.a 子集需要执行器 主题成员 JavaScript语言精粹(修订版) · JSLint 理解等级:未标注
  • 展开或收起下级: 1623 截止时间传递避免处理已被放弃的请求 路径上下文 SRE:Google运维解密 · 第22章 处理连锁故障 理解等级:未标注
  • 展开或收起下级: 1715 复用先划边界 路径上下文 你真的会写代码吗-2021 · 请重复利用:可复用性 理解等级:未标注
    • 1715.c 擦除限制泛型 主题成员 你真的会写代码吗-2021 · 请重复利用:可复用性 理解等级:未标注
  • 展开或收起下级: 1806 manifest显式声明依赖 路径上下文 架构之美 · 记忆留存(Michael Nygard) 理解等级:未标注
  • 展开或收起下级: 1958 分治知识抽象三武器 路径上下文 恰如其分的软件架构 · 概述 理解等级:未标注
  • 展开或收起下级: 2276 架构是难以改变的决定 路径上下文 企业应用架构模式 理解等级:未标注

未编号或编号待整理

  • 空安全前置 理解等级:未标注

    基于Kotlin的Spring Boot微服务实战 · Kotlin的语法

  • 密封类限状态 理解等级:未标注

    基于Kotlin的Spring Boot微服务实战 · Kotlin的语法

来源书籍

来源书籍

Effective Go中文版

编程语言类

Skill 版本:v23

书籍类型:未标注

清单覆盖 6/9

80 张卡片

来源书籍

Go语言底层原理剖析

编程语言类

Skill 版本:v23

书籍类型:经典原理

清单覆盖 8/9

182 张卡片

来源书籍

企业应用架构模式

系统架构类

Skill 版本:v23

书籍类型:经典原理

清单覆盖 3/6

177 张卡片

来源书籍

你真的会写代码吗-2021

代码可读性与重构类

Skill 版本:v23

书籍类型:经典原理

清单覆盖 7/7

109 张卡片

来源书籍

架构之美

系统架构类

Skill 版本:v23

书籍类型:未标注

清单覆盖 5/7

194 张卡片

主题索引

认证与密码学基础

比较 HTTP 认证方案、OAuth2 与 JWT、会话状态,以及摘要、加密、签名、证书与 TLS 的密码学基础。

253 张卡片 · 58 本书

主题索引

事务与离线并发控制

系统事务的隔离与锁,以及跨越多个请求的业务事务如何用乐观/悲观离线锁、粗粒度锁和隐含锁保持一致。

188 张卡片 · 35 本书

主题索引

软件质量属性的取舍

比较内部与外部质量、多准则权衡以及“先满足当前需求”在不同质量目标之间的取舍方法。

84 张卡片 · 24 本书

主题索引

业务事务与离线并发

业务事务比系统事务长得多,中间隔着用户思考时间:乐观离线锁与悲观离线锁怎么选、粗粒度锁与隐含锁的代价、版本号与条件更新怎样防止覆盖、预留与冻结怎样替代事后校验,以及离线并发为什么能免则免。

79 张卡片 · 28 本书

主题索引

简单性与复杂度控制

比较区分必要与意外复杂度、删减代码与接口、以简化方案推进工程的做法。

72 张卡片 · 25 本书

主题索引

语言安全子集与编码纪律

比较如何从语言中划出可靠子集、以编码约定和工具约束规避语言缺陷。

71 张卡片 · 7 本书