YAML 解释:语法、挪威问题和我们测试的其他陷阱

  1. 首页
  2. 博客
  3. 开发运营

开发运营

YAML 解释:语法、挪威问题和我们测试的其他陷阱

YAML 运行 Kubernetes、Docker Compose、GitHub Actions 和无数的配置文件。它看起来很友好,但不带引号的值可以默默地变成布尔值、浮点数和八进制数。我们将测试文件提供给真实的解析器以准确显示发生的情况。

阅读约 10 分钟
YAML 解释:语法、挪威问题和我们测试的其他陷阱

要点速览

  • YAML 表示带有缩进的数据:键值映射、带破折号的列表和标量值。
  • 不带引号的值是猜测的:在我们的测试中,NO 变成了 False,版本 1.10 变成了 1.1。
  • 引用看起来像布尔值、数字、时间或版本的字符串。
  • 切勿使用不安全的加载程序加载不受信任的 YAML;在 Python 中使用 yaml.safe_load。

配置文件列出了启用该功能的国家/地区:GB、SE、FI 和 NO。除了挪威,一切正常。该代码接收 False 而不是字符串“NO”,因为 YAML 解析器认为“NO”表示“否”。这就是著名的挪威问题,它只是 YAML 悄悄更改数据的几种方式之一。

我们在 Python 3.13 上使用 PyYAML 6.0 解析了一个故意棘手的文件。下面显示的每个值和类型都来自该运行。其他解析器,尤其是那些遵循 YAML 1.2 的解析器,可能会给出不同的结果,这是问题的一部分。

什么是 YAML?

YAML 是“YAML Ain’t Markup Language”的缩写,是一种人性化的结构化数据格式。它包含与 JSON、映射、列表、字符串、数字、布尔值和空值相同类型的内容,但使用缩进而不是大括号并允许注释。事实上,有效的 JSON 几乎总是有效的 YAML。它的可读性使其成为 DevOps 工具中配置的默认配置:Kubernetes 清单、Docker Compose 文件、GitHub Actions 工作流程和 Ansible playbook。

基本语法

# a comment
name: shop-api            # a map: key, colon, space, value
replicas: 3
enabled: true
tags:                     # a list: each item starts with "- "
  - web
  - payments
database:                 # a nested map, indented by two spaces
  host: db.internal
  port: 5432
inline_list: [a, b, c]
inline_map: {x: 1, y: 2}

缩进显示嵌套,冒号和破折号后需要空格。每层两个空间是常见的惯例。映射列表在 Kubernetes 中非常常见,它将两者结合起来:每个 - 启动一个新映射,其键在其下方排列。

YAML 如何猜测类型

不带引号的值不会自动成为字符串。解析器查看它并决定它是布尔值、数字、空值还是字符串。以下是 PyYAML 从我们的测试文件生成的内容:

YAML 解析值 类型
国家: 否 错误 布尔值
启用:是 真实 布尔值
调试:关闭 错误 布尔值
版本:1.10 1.1 浮动
蟒蛇:3.10 3.1 浮动
邮编: 01234 668 整数
八进制:0755 493 整数
端口:08 '08' 斯特
时间:12:30 750 整数
沙:1e10 '1e10' 斯特
空: 无 无类型
波形符: ~ 无 无类型
引用号:“否” ‘不’ 斯特
引用版本:“1.10” '1.10' 斯特

只有引用的值与所写的完全一致。引用的上方的每一行都是潜在的错误。

挪威问题

countries: [GB, NO, SE, FI]
# parsed: ['GB', False, 'SE', 'FI']

根据 PyYAML 遵循的 YAML 1.1 规则,各种大小写的单词 yes、no、on、off、y 和 n 都是布尔值。因此,挪威的国家代码变成了False,而其邻国则保留了字符串。同样的事情也可能发生在调查文件中的答案、名为“on”的功能标志或与这些单词之一匹配的任何短代码上。一旦您知道了,解决方法就很简单:引用该值,"NO"。

变化的数字

版本变成浮动版本

1.10 和 3.10 被解析为数字 1.1 和 3.1,丢失了尾随零。需要 Python 3.10 的 CI 文件可能实际上需要 Python 3.1。 GitHub Actions 用户已经达到了这一点,标准建议是引用版本:python-version: "3.10"。另请参阅我们的语义版本控制指南,了解为什么版本不是数字。

前导零表示八进制

邮政编码 01234 变为 668,因为在 YAML 1.1 中前导零标记八进制(以 8 为基数)数字。这对于像 0755 这样的文件权限很有用,它变成了 493,但对于邮政编码、电话号码和 ID 来说却是灾难性的。奇怪的是,08 仍然是一个字符串,因为 8 不是有效的八进制数字,因此外观相似的值最终可能会在同一文件中出现不同的类型。

时间变成秒

12:30 变为 750。YAML 1.1 将冒号分隔的数字读取为基数 60,即“六十进制”格式,因此 12 × 60 + 30 = 750。可以静默转换诸如 22:22 之类的计划或端口映射。为此,Docker Compose 文档建议引用端口映射。

而相反的惊喜

1e10 在 PyYAML 中保留了一个字符串,因为它的浮点模式需要小数点。另一个解析器可能会将其读为一百亿。依靠解析器来猜测是本节中每个问题的根源。

经验法则: 如果某个值是文本,并且仅由数字、点、冒号组成,或者是像 yes、no、on 或 off 这样的简短单词,请将其放在引号中。引用字符串永远不会错。

YAML 1.1 与 1.2

2009 年发布的 YAML 1.2 修复了大部分问题。它仅接受 true 和 false 作为布尔值,使用 0o 作为八进制,并删除以 60 为基数的数字。但许多广泛使用的库(包括 PyYAML)默认情况下仍遵循 1.1,并且基于它们构建的工具继承了该行为。 Python 的 ruamel.yaml 等库实现了 1.2。由于两个工具可能以不同的方式读取同一文件,因此唯一的安全习惯是引用不明确的值,无论版本如何。

缩进和制表符

YAML 不允许使用制表符进行缩进。我们使用选项卡进行的测试从 while scanning for the next token 开始产生了错误。未对齐的缩进同样致命:列表项的缩进比其同级项的缩进少一个空格while parsing a block mapping。配置编辑器以插入空格并显示空格,并始终在编辑后进行验证。缩进错误是“小配置更改”后部署失败的最常见原因。

重复的钥匙

name: first
name: second
# parsed: {'name': 'second'}

PyYAML 默默地接受重复项并保留最后一个值。 YAML 规范规定键必须是唯一的,并且一些解析器拒绝重复,但许多解析器则不然。在很长的 Kubernetes 清单中,重复的密钥可以悄悄地覆盖之前定义的设置。 Linters 可靠地捕获了这一点。

多行字符串

literal: |
  line one
  line two
folded: >
  line one
  line two

# literal: 'line one\nline two\n'
# folded:  'line one line two\n'

管道 | 保留换行符,适合脚本、证书和 SQL。 > 将行折叠成一行,适合长描述。添加 -(如 |- 中所示)会删除最后的换行符,这在精确比较值或用作机密时很重要。

锚点和合并键

defaults: &defaults
  retries: 3
  timeout: 30
prod:
  <<: *defaults
  timeout: 60

# prod: {'retries': 3, 'timeout': 60}

&defaults命名一个块,*defaults重用它,<<将它合并到一个地图中,本地密钥获胜。这避免了 Docker Compose 和 CI 文件中的重复。谨慎使用:大量使用锚点会使文件难以阅读,并且 << 合并键不是 YAML 1.2 的一部分,因此工具之间的支持有所不同。

安全装载

一些 YAML 加载器可以从特殊标签创建任意编程语言对象,这意味着加载不受信任的 YAML 可以运行代码。 PyYAML 的 safe_load 拒绝此类标签。当我们尝试加载要求 os.system 的文档时,它失败并显示 could not determine a constructor for the tag 'tag:yaml.org,2002:python/object/apply:os.system'。除非有特殊原因,否则请始终使用 yaml.safe_load,并且切勿对来自用户或互联网的文件使用不安全的加载程序。

检测和验证

  • yamllint 捕获制表符、错误缩进、重复键、尾随空格和真实值,如 yes。
  • 模式检查结构和类型; VS Code 等编辑器可以在您键入时根据 JSON 模式验证 Kubernetes、Compose 和 GitHub Actions 文件。
  • 特定于工具的检查, 例如 kubectl apply --dry-run=server 或 docker compose config,根据工具实际接受的内容进行验证。
  • 在 CI 中运行它们, 因此,损坏的配置会导致拉取请求失败,而不是部署失败。

我们没有为本文运行 yamllint 或这些工具检查。对于机密,请将它们完全排除在 YAML 文件之外,并从 环境变量 或机密管理器加载它们。

最后的话

YAML 读起来很愉快,但盲目信任是危险的。在我们的测试中,它的类型猜测将国家代码转换为布尔值,版本转换为浮点数,邮政编码转换为八进制数字,时间转换为秒。引用任何文本内容,使用空格而不是制表符,使用安全加载器加载,并在管道中放置 linter。

常见问题

YAML 中的挪威问题是什么?

根据 YAML 1.1 规则,未加引号的国家/地区代码 NO 被读取为布尔值 false。在我们的测试中,[GB, NO, SE, FI] 变成了 [‘GB’, False, ‘SE’, ‘FI’]。引用“NO”可以修复它。

为什么我的3.10版本变成了3.1?

不带引号的 3.10 被解析为浮点数,它会删除尾随零。引用版本,例如“3.10”。

我可以在 YAML 中使用选项卡吗?

不可以。YAML 需要缩进空格。正如我们的测试中一样,选项卡会导致解析错误。

| 有什么区别?和 > 在 YAML 中?

| 的 |样式准确地保持换行符。 > 样式将行折叠成一行,并用空格将它们连接起来。

YAML 是 JSON 的超集吗?

YAML 1.2 被设计为 JSON 的超集,因此几乎所有 JSON 文档都是有效的 YAML。反之则不然。

继续学习

与Stack Quora合作

需要测试、WordPress 或 SEO 方面的帮助?

我们帮助团队交付更好的软件并发展他们的网站。告诉我们您正在做什么,我们将建议明确的下一步。

继续阅读

更多指南 测试、人工智能和现代开发

喜欢这篇文章吗?选择一个主题并直接跳至我们最新的教程。

人工智能

RAG 分块策略解释:固定、重叠、句子、递归和标题、测量

RAG 分块策略在一份文档上与 tiktoken 0.14 进行比较:固定大小、重叠、句子打包、递归拆分和基于标题的分块、测量拆分事实、孤立标题和存储成本。

阅读文章 →
软件开发

API 幂等性解释:幂等密钥和安全重试,经过测试

API 幂等性通过我们运行的 Python 服务器和客户端进行了解释:丢失的响应导致在没有密钥的情况下产生双重费用,在有密钥的情况下产生单次费用,再加上密钥重用、并发重试和存储规则。

阅读文章 →
DevOps

Git Stash 解释:保存、应用、弹出和未跟踪的文件,经过测试

Git stash 用我们在 Git 2.56 上运行的命令进行了解释:推送消息、未跟踪的文件、列表和显示、应用与弹出、保留索引、冲突、存储分支、删除和清除。

阅读文章 →
软件测试

成对测试解释:全成对如何将 216 次测试减少到 13 次,已测试

成对测试用我们在 Python 3.13 中运行的生成器进行了解释:检查 13 个测试覆盖的 216 种组合、经过验证的覆盖范围、更大的示例以及成对可能错过的三向错误。

阅读文章 →
测试自动化

测试替身解释:Dummy、Stub、Spy、Mock 和 Fake,以及经过测试的 Python 代码

测试替身通过在 pytest 9.2 中运行的一个 Python 示例进行了解释:dummy、stub、spy、mock 和 fake、何时使用每一种、状态与行为检查,以及 autospec 如何捕获普通 Mock 隐藏的错误。

阅读文章 →
数据库与 SQL

SQL COALESCE 解释:默认值、NULLIF、IFNULL 与 ISNULL 和陷阱,已测试

SQL COALESCE 解释了我们在 SQLite 3.50 中运行的查询:第一个非空值、空字符串、数学中的 NULL、除以零的 NULLIF、聚合、LEFT JOIN 间隙以及 IFNULL 与 ISNULL。

阅读文章 →
数据库与 SQL

SQL 自连接解释:员工-经理、配对和行比较,经过测试

SQL 自连接用我们在 SQLite 3.50 中运行的查询来解释:员工和经理,收入比经理多,唯一对,每日变化,两跳链和索引。

阅读文章 →
软件开发

JavaScript Spread 运算符解释:Spread 与 Rest、副本和陷阱、经过测试

JavaScript 扩展运算符用我们在 Node 24 上运行的代码进行了解释:数组、对象、浅拷贝、剩余参数、Math.max 限制和 reduce 中的性能陷阱。

阅读文章 →
软件开发

Python 集合模块解释:Counter、defaultdict、deque 等,已测试

Python 集合用我们在 Python 3.13 上运行的代码进行了解释:Counter、defaultdict、deque、namedtuple、OrderedDict 和 ChainMap,以及列表与双端队列计时和备忘单。

阅读文章 →
人工智能

LLM 上下文窗口解释:标记、限制以及如何适应更多、衡量

LLM 上下文窗口用我们使用 tiktoken 测量的令牌计数进行了解释:散文、代码和印地语的单词与令牌、输入和输出预算、修剪聊天记录、RAG 和成本的分块。

阅读文章 →
软件开发

Webhooks 解释:它们如何工作以及如何安全地接收它们

Webhooks 解释了我们在 Python 中运行的接收器和发送器:推送与轮询、HMAC-SHA256 签名、拒绝篡改和重播的请求、使用回退重试、幂等性和测试技巧。

阅读文章 →
DevOps

Git Cherry-Pick 解释:安全地、经过测试地复制您需要的提交

Gitcherry-pick 用我们在 Git 2.56 中运行的命令进行了解释:将修补程序复制到发布分支、新的哈希值和补丁 ID、-x、-n、提交范围、冲突、–abort、–skip 以及稍后的合并。

阅读文章 →
测试自动化

快照测试解释:它是如何工作的、何时有用、何时有害

快照测试通过我们运行的 pytest 和糖浆演示进行了解释:创建快照、在代码更改后读取差异、屏蔽时间戳、安全更新以及快照何时有帮助或有害。

阅读文章 →
软件测试

突变测试解释:为什么 100% 覆盖率仍然漏掉了我们的 bug

突变测试用我们构建并运行的一个小型突变工具进行解释:14 个突变体,一个 100% 线覆盖的测试套件,得分为 79%,边界测试达到 100%,加上工具、成本和 CI 技巧。

阅读文章 →
人工智能

即时注入解释:人工智能应用程序如何被欺骗以及如何防御它们

为构建者解释提示注入:直接和间接攻击、关键字过滤器失败的原因(我们的测试阻止了 4 中的 1 个)以及分层防御,包括最小权限、工具允许列表和输出检查。

阅读文章 →
DevOps

DNS 记录解释:A、AAAA、CNAME、MX、TXT 和 TTL 以及真实查找

通过我们运行的查找来解释 DNS 记录:解析如何工作、A 和 AAAA、CNAME 规则、MX 和 null MX、用于 SPF 和验证的 TXT、NS、TTL 和缓存以及安全 DNS 更改。

阅读文章 →
DevOps

功能标志解释:安全发布、逐步推出和标志卫生

通过我们运行的推出模拟解释了功能标志:标志类型、具有稳定散列的百分比推出、终止开关、允许列表、测试两条路径、标志债务和最佳实践。

阅读文章 →
测试自动化

使用 Python Faker 测试数据生成:真实、可重复且安全的数据

使用 Python Faker 测试数据生成、运行和测量:可重复数据的播种、区域设置、唯一值、域形状记录、Faker 未命中的边缘情况、屏蔽生产数据和速度。

阅读文章 →
软件测试

左移测试解释:尽早发现错误而不拖慢团队速度

左移测试解释:它意味着什么,为什么早期缺陷成本更低,从需求审查到 CI 检查的实践,测试人员角色的变化,右移,指标和推出计划。

阅读文章 →
数据库与 SQL

SQL 字符串函数解释:TRIM、SUBSTR、REPLACE、CONCAT 和数据清理

通过我们运行的查询来解释 SQL 字符串函数:连接和 NULL、TRIM、UPPER 和 LOWER、SUBSTR 和 INSTR、REPLACE、填充、Unicode 长度、清理混乱数据和方言差异。

阅读文章 →
数据库与 SQL

SQL 触发器解释:BEFORE 和 AFTER 触发器、审核日志和陷阱

SQL 触发器用我们运行的触发器进行了解释:BEFORE 与 AFTER、OLD 和 NEW、审核日志、验证、库存更新、WHEN 条件、回滚、方言差异以及何时避免它们。

阅读文章 →
软件开发

Python JSON 模块解释:转储、加载、自定义类型和常见错误

Python JSON 模块用我们运行的代码进行了解释:转储和加载、文件、类型转换、日期和小数、自定义编码器、object_hook、浮点精度、解析错误和 JSON 行。

阅读文章 →
软件开发

ES 模块与 CommonJS:JavaScript 导入如何在 Node.js 中工作并经过测试

ES 模块与 CommonJS 用我们在 Node.js 中运行的代码进行了解释:导入和导出语法、require、实时绑定、缓存、顶级等待、动态导入、文件扩展和互操作。

阅读文章 →
软件开发

Python 正则表达式解释:模式、组、前瞻和陷阱,经过测试

Python 正则表达式用我们运行的模式进行解释:搜索与匹配、findall、组和命名组、贪婪与懒惰、sub、前瞻、标志、Unicode 惊喜和灾难性回溯。

阅读文章 →
人工智能

LLM 结构化输出解释:从 AI 模型获取可靠的 JSON

LLM 结构化输出通过我们在 Pydantic 中运行的验证进行了解释:JSON 模式和模式、约束解码、模型输出中断的方式、重试循环和语义检查。

阅读文章 →
DevOps

SSH 密钥解释:它们如何工作、ssh-keygen、Ed25519 和安全习惯

SSH 密钥用我们生成的密钥进行解释:公钥与私钥、ssh-keygen、Ed25519 与 RSA、指纹、密码、ssh-agent、authorized_keys、配置文件、GitHub 和密钥卫生。

阅读文章 →
DevOps

HTTP 缓存解释:缓存控制、ETag 和 304 响应,通过实时测试

使用我们运行的小型服务器解释 HTTP 缓存:Cache-Control 指令、max-age、无缓存与无存储、ETag 重新验证和 304 响应、CDN、缓存清除和测试标头。

阅读文章 →
测试自动化

API 合约测试解释:在发布之前捕获重大变更

API 合约测试通过我们运行的模式检查进行了解释:什么是合约、消费者驱动的合约、Pact、OpenAPI、哪些更改会破坏消费者,以及它如何适应 CI。

阅读文章 →
软件测试

基于风险的测试解释:对风险进行评分、构建矩阵并测试重要内容

基于风险的测试逐步解释:识别风险、对可能性和影响进行评分、构建风险矩阵、将风险映射到测试深度、工作示例和常见错误。

阅读文章 →
数据库与 SQL

SQL 约束解释:NOT NULL、UNIQUE、CHECK 和 FOREIGN KEY,已测试

通过我们运行的测试解释了 SQL 约束:NOT NULL、UNIQUE、CHECK、DEFAULT、PRIMARY 和 FOREIGN KEY、NULL 漏洞、SQLite 的外键设置、命名约束并测试它们。

阅读文章 →
数据库与 SQL

SQL 日期函数解释:无错误地添加、比较和分组日期

SQL 日期函数通过我们运行的查询进行解释:添加间隔、月末惊喜、日期差异、BETWEEN 陷阱、按天分组、时区、索引和方言差异。

阅读文章 →
软件开发

Python asyncio 解释:async、await、gather 和 TaskGroup With Real Timings

Python asyncio 用我们计时的代码进行了解释:协程、await、gather、TaskGroup、错误处理、超时、限制并发以及破坏性能的阻塞调用错误。

阅读文章 →
软件开发

JavaScript 中的 Debounce 与 Throttle:它们如何工作、何时使用、经过测试

JavaScript 中的反跳与节流通过我们在 Node.js 中测量的计时进行了解释:每种方式如何工作、简单实现、前导和尾随调用、真实用例和测试。

阅读文章 →
软件开发

Python 上下文管理器解释:with 语句、contextlib 和实际用途

Python 上下文管理器用我们运行的代码进行了解释:如何工作、__enter__ 和 __exit__、contextlib.contextmanager、suppress、ExitStack、数据库事务和常见错误。

阅读文章 →
人工智能

LLM 温度和 Top-p 解释:AI 模型如何选择下一个单词

LLM 温度和 top-p 通过我们运行的模拟进行了解释:概率如何重塑、top-p 保留什么、按任务推荐的设置、确定性和测试 AI 功能。

阅读文章 →
DevOps

YAML 解释:语法、挪威问题和我们测试的其他陷阱

YAML 通过解析器测试进行解释:基本语法、列表和地图、挪威问题、版本转换为浮点数、八进制邮政编码、六十进制时间、锚点、多行文本和安全加载。

阅读文章 →
DevOps

Cron 作业解释:语法、实际计划以及破坏它们的错误

Cron 作业通过我们验证的时间表进行了解释:五个字段、运算符、真实示例、每月或每周的陷阱、环境问题、日志记录、重叠和时区。

阅读文章 →
人工智能

人工智能幻觉解释:语言模型为何会产生幻觉以及如何减少它

人工智能幻觉解释:它们是什么,为什么语言模型产生它们,常见类型,如何通过基础和提示来减少它们,以及我们进行的简单检查。

阅读文章 →
DevOps

环境变量解释:.env 文件、秘密和配置正确完成

使用我们运行的 Python 示例解释环境变量:读取和设置它们、为什么每个值都是字符串、.env 文件、进程继承、秘密和验证。

阅读文章 →
软件开发

API 速率限制解释:算法、标头和处理 429 错误

API 速率限制通过我们运行的模拟进行了解释:令牌桶、固定窗口、滑动窗口、429 响应、速率限制标头、带回退的重试和测试限制。

阅读文章 →
测试自动化

Python 中的模拟:unittest.mock、补丁以及导致测试谎言的错误

使用unittest.mock 在Python 中进行模拟,经过测试:模拟和return_value、side_effect、修补使用名称的位置、spec 和autospec、模拟日期以及常见错误。

阅读文章 →
软件测试

代码覆盖率解释:行覆盖率与分支覆盖率以及 100% 的真正含义

用真实的coverage.py运行来解释代码覆盖率:行、分支和条件覆盖率,阅读报告,为什么100%覆盖率仍然会错过错误,以及合理的目标。

阅读文章 →
数据库与 SQL

SQL 中的 DELETE、TRUNCATE 和 DROP:差异、回滚以及何时使用它们

DELETE、TRUNCATE 和 DROP 通过经过测试的 SQL 进行了解释:各自删除什么、回滚、触发器、身份重置、速度,以及 PostgreSQL、MySQL、SQL Server 和 SQLite 有何不同。

阅读文章 →
数据库与 SQL

SQL 视图解释:创建、使用和避免陷阱(附示例)

SQL 视图通过我们运行的查询进行解释:创建视图、实时结果、隐藏列、性能、可更新和物化视图、破坏的依赖关系和最佳实践。

阅读文章 →
软件开发

TypeScript 接口与类型:真正的差异,使用编译器进行测试

TypeScript 接口与类型,使用真实编译器进行检查:两者都可以做什么,只有一个可以做什么,声明合并,扩展与交集以及要遵循的简单规则。

阅读文章 →
软件开发

Python *args 和 **kwargs 解释:灵活的函数和清晰的示例

Python *args 和 **kwargs 用我们运行的代码进行了解释:打包和解包、参数顺序、仅关键字和仅位置参数、装饰器和常见错误。

阅读文章 →
软件开发

Python Lambda 函数:语法、实际用途以及何时不使用它们

Python lambda 函数用我们运行的代码进行了解释:语法、使用键排序、映射和过滤器、闭包、后期绑定陷阱,以及何时普通 def 是更好的选择。

阅读文章 →
人工智能

什么是人工智能代理?它们是如何工作的,只需运行一个简单的代理循环

什么是人工智能代理?关于代理循环、工具、内存和护栏的简单指南,以及我们运行的一个小型 Python 循环、真正的风险以及何时简单的聊天机器人是更好的选择。

阅读文章 →
DevOps

监控与可观察性:真正的区别,包括日志、指标和跟踪

监控与可观察性解释:已知和未知的故障、日志、指标和跟踪、检查事件演练、黄金信号、OpenTelemetry 和有用的警报。

阅读文章 →
DevOps

Docker Volumes 与 Bind Mounts:以正确的方式保留容器数据

Docker 卷与绑定挂载解释:为什么容器数据消失、命名卷、绑定挂载、tmpfs、Compose 示例、备份、权限以及何时使用它们。

阅读文章 →
测试自动化

TDD 与 BDD:主要区别、以两种方式构建的一个功能以及何时使用每种方式

TDD 与 BDD 的解释是通过一种双向构建的折扣功能:使用我们运行的代码进行红绿重构、Given-When-Then 场景、工具、权衡以及何时使用每种方案。

阅读文章 →
软件测试

用户验收测试 (UAT):流程、清单和真实示例

用户验收测试解释:谁运行它、它与 QA 有何不同、七步流程、UAT 测试用例模板、清单、签核标准和常见错误。

阅读文章 →
数据库与 SQL

SQL NULL 值解释:IS NULL、COALESCE、NULLIF 和要避免的陷阱

通过我们运行的查询解释了 SQL NULL 值:三值逻辑、IS NULL、COALESCE、NULLIF,聚合、连接和排序如何处理 NULL,以及它悄悄引起的错误。

阅读文章 →
数据库与 SQL

SQL CASE WHEN 语句:语法、实例和常见错误

SQL CASE WHEN 解释了我们运行的查询:简单和搜索表单、条件顺序、SUM 透视、COUNT 技巧、自定义排序、更新和要避免的 NULL 陷阱。

阅读文章 →
软件开发

什么是智威汤逊?通过工作示例解释 JSON Web 令牌

什么是智威汤逊? JSON Web Tokens 解释:这三个部分,在我们运行的代码中构建和篡改的令牌,JWT 与会话,存储,刷新令牌和安全错误。

阅读文章 →
软件开发

JavaScript 事件循环解释:调用堆栈、微任务和计时器以及示例

JavaScript 事件循环用我们运行的代码进行了解释:调用堆栈、任务和微任务队列、为什么 setTimeout 0 不是立即执行、阻塞、饥饿和面试测验。

阅读文章 →
软件开发

Python 生成器和 Yield 解释:通过真实示例节省内存

Python 生成器和yield 用我们运行的代码进行了解释:它们如何暂停和恢复、测量内存节省、管道、无限序列、yield from、发送和常见陷阱。

阅读文章 →
人工智能

什么是嵌入?向量和余弦相似度简单解释

什么是嵌入?关于向量、余弦相似度和语义搜索的简单语言指南,其中包含我们运行的一个小示例、常见用途、选择模型和已知限制。

阅读文章 →
DevOps

蓝绿部署与金丝雀部署:差异、权衡以及如何选择

蓝绿部署与金丝雀部署解释:每种部署的工作原理、成本、风险和回滚、我们测试的稳定用户分桶、数据库迁移、滚动更新以及如何选择。

阅读文章 →
测试自动化

不稳定的测试:造成这些问题的原因以及如何彻底解决它们

我们运行的演示解释了不稳定的测试:主要原因、如何确认和诊断、正确的时间修复、共享状态和日期以及隔离过程。

阅读文章 →
软件测试

负载测试与压力测试:差异、指标和 k6 示例

负载测试与压力测试的解释:各自证明什么、峰值和浸泡测试、重要的指标、为什么平均值会误导、k6 个示例以及如何计划测试。

阅读文章 →
软件测试

测试用例与测试场景:主要区别、示例以及何时使用它们

测试用例与测试场景的解释:清晰的定义、并排的表格、从场景到案例的密码重置功能、模板以及何时使用每个功能。

阅读文章 →
数据库与 SQL

SQL 查询优化:读取执行计划并修复慢速查询(带计时)

对一百万行进行 SQL 查询优化测试:读取执行计划、添加正确的索引、修复不可控制的过滤器、使用复合索引和键集分页。

阅读文章 →
数据库与 SQL

SQL UNION 与 UNION ALL:差异、示例和性能测试

SQL UNION 与 UNION ALL 通过我们运行的查询进行了解释:重复、都遵循的规则、真实的数据错误、测量的性能、INTERSECT 和 EXCEPT 以及何时使用它们。

阅读文章 →
软件开发

JavaScript Fetch API 教程:GET、POST、错误处理和超时

针对本地服务器测试的 JavaScript Fetch API 教程:GET 和 POST、为什么不抛出 404、可重用的帮助程序、查询字符串、超时、CORS 和常见错误。

阅读文章 →
软件开发

Python 文件处理:读取、写入、CSV、JSON 和 pathlib 以及示例

使用我们运行的代码解释了 Python 文件处理:打开模式、使用、读取大文件、CSV、JSON、pathlib、二进制文件、安全写入、错误处理和常见错误。

阅读文章 →
软件开发

Python 类和对象:带有实际示例的 OOP 教程

用我们运行的代码解释 Python 类和对象:__init__、方法、类与实例属性、继承、属性、dunder 方法、数据类和常见错误。

阅读文章 →
人工智能

什么是大语言模型?法学硕士如何运作,在没有炒作的情况下进行解释

什么是大语言模型?法学硕士用简单的语言解释:标记、嵌入、注意力、训练、温度和上下文窗口、一个微小的下一个单词演示和真正的限制。

阅读文章 →
DevOps

适合初学者的 Linux 命令:带有示例的基本终端指南

适合初学者的 Linux 命令,按任务分组:导航、文件、查看日志、grep、管道、权限、进程和档案,并附有实用的日志分析示例。

阅读文章 →
测试自动化

Selenium 与 Playwright:主要区别、代码比较以及选择

Selenium 与 Playwright 比较:架构、等待、浏览器和语言支持、调试、两种工具中的相同测试、迁移建议以及如何选择。

阅读文章 →
软件测试

等价划分:通过实例解释测试设计技术

等效分区解释:如何找到有效和无效分区,年龄、密码和优惠券的工作示例,我们运行的测试,以及为什么将其与边界配对。

阅读文章 →
软件测试

软件测试中的严重性与优先级:差异、矩阵和实例

软件测试中的严重性与优先级解释:清晰的定义、带有示例的四向矩阵、级别尺度、谁设置每个级别以及如何运行错误分类。

阅读文章 →
数据库与 SQL

SQL 子查询教程:类型、相关子查询和 EXISTS 以及示例

SQL 子查询教程,其中包含我们运行的查询:标量、IN、FROM 和 SELECT 子查询、相关子查询、EXISTS、NOT IN NULL 陷阱以及子查询与 JOIN 与 CTE。

阅读文章 →
数据库与 SQL

SQL 事务和 ACID 解释:COMMIT、ROLLBACK 和隔离级别

SQL 事务和 ACID 通过我们运行的银行转账进行了解释:COMMIT、ROLLBACK、保存点、锁、隔离级别、脏读、死锁和最佳实践。

阅读文章 →
软件开发

Git 命令备忘单:您实际使用的命令,以及示例

Git 命令备忘单按任务分组:设置、暂存、分支、远程、存储、历史记录和撤消错误,以及来自真实演示存储库的输出。

阅读文章 →
软件开发

JavaScript Promise 解释:then、catch、Promise.all 和常见错误

JavaScript 承诺用我们运行的代码进行了解释:状态、then 和 catch 链、错误处理、Promise.all、allSettled、race 和 any、事件循环和常见错误。

阅读文章 →
软件开发

Python 字典教程:方法、示例和常见模式

Python 字典教程,包含我们运行的代码:创建、读取和更新字典、关键方法、合并、理解、计数和分组模式以及常见错误。

阅读文章 →
人工智能

什么是 RAG?通过工作示例解释检索增强生成

什么是RAG?检索增强生成逐步解释:索引、分块、嵌入、检索、一个小型的 Python 工作示例、评估和常见故障。

阅读文章 →
DevOps

Terraform 初学者教程:从第一个文件到模块的基础设施即代码

适合初学者的 Terraform 教程:从没有云帐户开始,学习初始化、计划和应用,然后是变量、输出、状态、模块和安全的团队工作流程。

阅读文章 →
DevOps

Docker 与 Kubernetes:主要区别、它们如何协同工作以及您需要哪些

Docker 与 Kubernetes 的解释:各自的作用、同一个应用程序同时运行、Docker Compose 和 Swarm 的比较、dockershim 的变化以及如何决定您需要什么。

阅读文章 →
测试自动化

Pytest 初学者教程:夹具、参数化和真实示例

面向初学者的 pytest 教程,其中包含我们在 pytest 9.2 上运行的测试:断言、固定装置、参数化、conftest、标记、tmp_path、monkeypatch、有用的标志和 CI。

阅读文章 →
软件测试

软件测试生命周期 (STLC):6 个阶段、进入和退出标准、示例

软件测试生命周期解释:六个 STLC 阶段,包括进入和退出标准、可交付成果、有效的登录功能示例、STLC 与 SDLC 以及敏捷中的 STLC。

阅读文章 →
软件开发

Git merge 与 rebase 的区别:示例及如何选择

用真实的 log 输出、对比表、rebase 黄金法则和安全的团队工作流,讲清 Git merge 与 rebase 的区别。

阅读文章 →
软件开发

Python 列表推导式:语法、示例与何时避免使用

Python 列表推导式详解:语法、过滤、if-else、嵌套循环、实测耗时,以及何时普通 for 循环更合适。

阅读文章 →
数据库与 SQL

SQL JOIN 详解:附示例(INNER、LEFT、RIGHT、FULL)

通过示例表和查询,一步步讲解 SQL JOIN:INNER、LEFT、RIGHT、FULL、CROSS 和 SELF,并介绍常见错误与性能技巧。

阅读文章 →