gh-pages项目CLI参数使用注意事项

gh-pages是一个流行的GitHub Pages部署工具，最新版本(v6.3.0)对命令行参数处理进行了重要更新，开发者需要注意这些变化以避免部署失败。

参数处理机制变更

在gh-pages v6.3.0版本中，项目将命令行参数处理依赖从v11升级到了v13，这一变更带来了一个重要的行为变化：默认情况下，命令行工具现在会严格检查参数数量。如果提供了超出预期的参数，工具将直接报错终止执行，而不是像之前版本那样忽略多余参数。

常见错误场景

许多开发者习惯在布尔型参数后添加值，例如：

gh-pages -d build -t true

这在v6.3.0中会触发错误："error: too many arguments. Expected 0 arguments but got 1."，因为-t(或--dotfiles)是一个布尔标志，不应该接受任何参数值。

正确使用方法

对于布尔型参数，只需指定标志本身即可，无需添加值：

gh-pages -d build -t

或者使用完整参数名：

gh-pages --dist build --dotfiles

技术背景

这种变更源于命令行参数处理库的设计理念变化，旨在提高命令行工具的严谨性和可预测性。布尔标志(boolean flags)本身已经表达了"开启"的含义，附加的值反而会造成歧义。现代命令行工具普遍采用这种设计范式，如git、npm等工具也都遵循类似的参数规范。

迁移建议

对于现有项目：

1. 检查package.json中所有使用gh-pages的脚本命令
2. 移除布尔参数后的值(true/false)
3. 测试部署流程确保一切正常

这种变更虽然小，但体现了命令行工具设计的最佳实践，有助于构建更健壮和一致的开发工作流。