理解yamllint对GitHub Actions YAML文件的严格校验

在GitHub Actions工作流文件中使用YAML格式时，开发者可能会遇到yamllint工具的严格校验警告。特别是当工作流文件中包含某些特殊关键字时，yamllint会提示"truthy value should be one of [false, true]"的警告信息。

yamllint作为一款YAML格式校验工具，默认会对YAML文件进行严格检查。在GitHub Actions的上下文中，工作流文件通常会使用"on"作为触发条件的关键字，例如：

on: [push, pull_request]

或者

on:
  push:
    tags: ['**']

这些用法在GitHub Actions中是完全合法的，但yamllint会将其标记为警告，因为"on"在YAML 1.1规范中被视为布尔值"true"的别名。yamllint默认遵循YAML 1.1规范，因此会对这种用法发出警告。

针对这种情况，开发者有几种解决方案：

1. 显式声明YAML版本：在文件开头添加%YAML 1.2声明，因为YAML 1.2规范中移除了这种布尔值别名的设计。

%YAML 1.2
---
on: [push, pull_request]

2. 引用关键字：将"on"用引号包裹，明确表示它是一个字符串而非布尔值。

"on": [push, pull_request]

3. 禁用特定规则：在代码行中添加注释来临时禁用truthy规则的检查。

on: [push, pull_request]  # yamllint disable-line rule:truthy

4. 修改yamllint配置：在项目的.yamllint.yaml配置文件中全局禁用对关键字的truthy检查。

rules:
  truthy:
    check-keys: false

理解这些解决方案背后的原理很重要。YAML规范的发展导致了不同版本间的兼容性问题，而GitHub Actions选择支持更现代的YAML用法。作为开发者，我们需要在工具链的严格校验和实际使用场景之间找到平衡点。

对于团队项目，建议采用第一种或第四种方案，因为它们能提供一致的代码风格，并且不需要在每个文件中重复配置。个人项目则可以根据偏好选择最方便的方式。无论选择哪种方案，重要的是保持项目内部的一致性。