一位开发者通过 grep 弃用标记的方法，在 GitLab CLI 中发现了六处文档与代码矛盾的地方，并提交了修复。同时记录了新手在 CI 中容易掉入的两个陷阱。
具体发现包括：
1. glab issue list 和 glab incident list 的示例中使用了 --opened 标记，该标记已被隐藏、弃用且已是默认行为。
2. glab mr note 的帮助文档仍展示 --resolve 和 --unresolve，这两个标记已被子命令替代。
3. bug 报告模板建议使用 DEBUG=true，但实际需要 GLAB_DEBUG 前缀才能避免弃用警告。
4. deploy-key delete 声明参数可选，但实际未提供参数时会删除 ID 0 的部署密钥。
5. ci lint 不对远程 URL 进行状态码检查，指向 404 页面会将错误页 HTML 当作输入，返回误导的语法错误。
6. glab api 的数组参数正则只允许小写字母和下划线，包含大写字母或连字符时会静默转为 JSON 字符串。
另外，Windows 上的测试存在临时目录路径转义错误和 HOME 环境变量未设置两处问题。
CI 陷阱包括：新 GitLab 账号需完成身份验证才能使用共享 runner，否则管道无声失败；分支推送不触发 MR 管道，需通过草稿 MR 验证。该开发者提交了6个合并请求，全部通过：!3536 序列化数组元素大小写，!3537 使用 GLAB_DEBUG，!3538 停止指向弃用标记的帮助，!3539 修复 Windows 测试路径，!3540 要求 deploy-key delete 必传参数，!3541 拒绝无效远程 URL 响应。
#开发者 #工具 #GitLab #CLI #glab #Go #DevOps #文档
@DevToolboxHub