TestRail导入BDD feature文件失败，求正确格式规范

我尝试按照TestRail官方文档的「Import .feature files into TestRail」功能，将自动化框架中的现有BDD feature文件导入，但导入后未生成任何测试用例，且无法手动编辑测试用例添加内容。我调整过feature文件的格式但没有效果，不确定是文件需要遵循特定格式规范，还是功能本身存在问题。

排查步骤与解决方案 #

1. 严格遵循Gherkin格式规范 #

TestRail仅解析符合标准Gherkin语法的.feature文件，核心要求：

• 必须以Feature:开头定义功能模块
• 每个测试场景需用Scenario:或Scenario Outline:声明
• 步骤必须以Given/When/Then/And/But作为前缀

示例合规代码：

Feature: 用户登录流程
  验证不同登录场景的正确性

  Scenario: 正确凭证登录成功
    Given 打开登录页面
    When 输入用户名 "test_user" 和密码 "correct_pwd"
    Then 跳转至用户首页并显示欢迎信息

  Scenario Outline: 错误凭证登录失败
    Given 打开登录页面
    When 输入用户名 "<user>" 和密码 "<pwd>"
    Then 显示错误提示 "<msg>"

    Examples:
      | user      | pwd        | msg                     |
      | test_user | wrong_pwd  | 密码错误，请重试 |
      | fake_user | 123456     | 用户名不存在 |

2. 确认导入配置正确 #

导入时需检查以下选项：

• 选择有权限的目标测试项目和测试套件
• 确保勾选「为场景创建测试用例」类选项（不同版本表述可能有差异）
• 文件编码设置为UTF-8，避免特殊字符导致解析失败

3. 权限与版本验证 #

• 确认当前账号拥有「创建测试用例」「编辑测试用例」的权限
• 检查TestRail版本是否支持BDD导入功能，建议升级至v7.0及以上稳定版本

4. 查看系统日志定位问题 #

登录TestRail后台查看系统日志，导入失败时会记录具体错误（如格式错误、文件损坏），根据日志信息针对性修复。

内容的提问来源于stack exchange，提问作者Muj