Symfony 表单默认不会自动继承父表单的自定义选项，需显式通过 add() 方法的第三个参数（选项数组）手动传递所需 $options 给子表单类型。

symfony 表单默认不会自动继承父表单的自定义选项，需显式通过 `add()` 方法的第三个参数（选项数组）手动传递所需 `$options` 给子表单类型。

在 Symfony 表单开发中，一个常见误区是认为嵌套子表单（如 AnimalNameType::class）会自动继承父表单（如 BreedSurveyType）传入的自定义选项（如 'form_1' => true, 'units' => 'pounds'）。事实并非如此：Symfony 的表单选项作用域是隔离的，子表单仅接收其自身 configureOptions() 中定义的默认值，除非你主动将父级选项透传过去。

✅ 正确做法：显式透传选项

在父表单的 buildForm() 方法中，向每个子表单的 add() 调用额外传入一个选项数组，将需要的键值对原样或按需映射传递：

public function buildForm(FormBuilderInterface $builder, array $options): void
{
    if ($options['form_1'] === true) {
        $builder->add('name', AnimalNameType::class, [
            'form_1' => $options['form_1'],
            'form_2' => $options['form_2'],
            'units'  => $options['units'],
            'form_3' => $options['form_3'], // 注意：原文此处有笔误（写成 $options['form_2']），已修正
        ]);
    }

    if ($options['form_2'] === true) {
        $builder->add('sex', AnimalSexType::class, [
            'form_1' => $options['form_1'],
            'form_2' => $options['form_2'],
            'units'  => $options['units'],
            'form_3' => $options['form_3'],
        ]);
    }

    if ($options['form_3'] === true) {
        $builder->add('weight', AnimalWeightType::class, [
            'form_1' => $options['form_1'],
            'form_2' => $options['form_2'],
            'units'  => $options['units'],
            'form_3' => $options['form_3'],
        ]);
    }
}

同时，确保每个子表单类型（如 AnimalNameType）在其 configureOptions() 中声明并设置对应选项的默认值，以支持运行时注入：

// src/Form/AnimalNameType.php
public function configureOptions(OptionsResolver $resolver): void
{
    $resolver->setDefaults([
        'data_class' => AnimalName::class,
        'form_1'     => false,
        'form_2'     => false,
        'units'      => null,
        'form_3'     => false,
    ]);
}

⚠️ 注意事项：

• 不要依赖全局状态或服务传递配置：选项透传是 Symfony 表单设计的推荐方式，保持表单类型的可复用性与无状态性。
• 避免重复键名冲突：若子表单本身也使用同名选项（如 'label'、'required'），注意父级透传值会覆盖子表单的默认值——这正是你期望的行为。
• 批量透传？谨慎使用：虽然可写 ...$options 展开全部选项，但不推荐。应显式声明需透传的键，提高可读性、可维护性，并防止意外传递敏感或无关选项（如 'csrf_protection'）。

✅ 进阶建议：封装透传逻辑（提升可维护性）

当多个子表单需共享相同选项集时，可提取为私有方法或使用 OptionsResolver::setDefined() + setAllowedTypes() 强化类型校验：

private function getSharedOptions(array $parentOptions): array
{
    return array_intersect_key($parentOptions, array_flip([
        'form_1', 'form_2', 'units', 'form_3'
    ]));
}

// 然后在 buildForm 中调用：
$builder->add('name', AnimalNameType::class, $this->getSharedOptions($options));

通过以上方式，你不仅能精准控制子表单行为（例如根据 'units' => 'pounds' 渲染不同单位的输入控件），还能保证整个表单树的配置逻辑清晰、可测试、易扩展。