Cucumber.js 中特性文件路径通配符的使用注意事项

问题背景

在使用 Cucumber.js 进行行为驱动开发(BDD)测试时，开发者经常需要通过通配符(glob)模式来匹配多个特性文件(feature files)。然而，在实际使用过程中，开发者可能会遇到一个常见问题：通过命令行直接传递的通配符模式与在配置文件中指定的通配符模式表现不一致。

现象描述

当开发者尝试在命令行中直接使用类似 ./features/**/*.feature 这样的通配符模式时，发现它只能匹配一级子目录中的文件，而无法递归匹配更深层级的文件。然而，同样的通配符模式在 Cucumber.js 配置文件中使用时，却能够正常工作，递归匹配所有层级的特性文件。

原因分析

这个问题的根源在于 shell 对通配符的处理机制：

1. 命令行直接使用：当在 shell 中直接输入包含通配符的命令时，shell 会先进行通配符扩展，然后将扩展后的结果作为参数传递给程序。不同 shell 对通配符的处理方式可能不同，有些 shell 默认不会递归匹配多级目录。

2. 配置文件使用：当通配符模式写在 Cucumber.js 配置文件中时，是由 Cucumber.js 自己来解析和处理通配符，因此能够按照预期递归匹配所有层级的文件。

解决方案

要解决这个问题，有以下几种方法：

1. 使用引号包裹通配符：在命令行中使用单引号或双引号包裹通配符模式，防止 shell 提前展开。例如：

   cucumber-js './features/**/*.feature'
   

2. 使用配置文件：将通配符模式写在 Cucumber.js 配置文件中，这是更可靠的方式。

3. 调整 shell 设置：某些 shell 可以通过设置来改变通配符的行为，使其支持递归匹配。

最佳实践

1. 对于简单的项目，可以直接在命令行中使用引号包裹的通配符模式。

2. 对于复杂的项目，建议使用配置文件来管理特性文件的路径，这样不仅解决了通配符问题，还能更好地组织测试配置。

3. 在团队协作项目中，应该统一使用配置文件的方式，确保所有开发者获得一致的测试行为。

技术细节

• 在 Unix/Linux 系统中，shell 对通配符的处理遵循特定的规则，不同 shell (如 bash、zsh 等)可能有细微差别。

• Cucumber.js 内部使用 Node.js 的 glob 模块来处理通配符，这个模块提供了可靠的跨平台通配符匹配功能。

• 当通配符被 shell 提前展开时，Cucumber.js 接收到的已经是具体的文件路径列表，而非原始的通配符模式。

总结

理解 shell 和程序对通配符处理的不同机制，是解决这类问题的关键。在 Cucumber.js 测试中，推荐使用配置文件来指定特性文件路径，或者在命令行中使用引号包裹通配符模式，这样可以确保获得一致且可靠的文件匹配行为。