如何使用custom_module_form_user_register_form_alter修改用户资料字段属性

第一步：先确认表单字段的实际结构 #

绝大多数自定义字段修改失败的原因是找错了字段的数组层级，不要凭猜测写层级，先打印表单结构确认：

function custom_module_form_user_register_form_alter(&$form, FormStateInterface $form_state, $form_id) {
  // 安装了Devel模块的话用kint打印，结构更清晰
  kint($form);
  // 没装Devel的话用日志打印到后台日志里
  \Drupal::logger('custom_module')->debug('表单结构：@structure', ['@structure' => print_r($form, TRUE)]);
  
  // 原有基础字段修改逻辑保留
  $form['account']['mail']['#required'] = TRUE;
  $form['account']['mail']['#title'] = 'Changed title';
}

普通用户自定义字段的修改 #

直接附加在用户实体上的自定义字段，默认不在account分组下，直接在$form根层级下：

// 直接修改用户实体自带的自定义字段
$form['field_registration_code']['#title'] = "修改后的标题";
// 加ajax属性的示例
$form['field_registration_code']['widget'][0]['value']['#ajax'] = [
  'callback' => 'custom_module_fill_other_field',
  'wrapper' => 'other-field-wrapper',
  'event' => 'change',
];

内嵌实体（如Profile、Paragraph类型的关联资料字段）的修改 #

你之前的核心错误是把表单的name属性字符串当成了数组键，实际表单是多维数组结构，要分层级写：

// 针对survey_participants_profiles关联实体的字段修改
$form['survey_participants_profiles'][0]['entity']['field_registration_code']['widget'][0]['value']['#title'] = "修改后的标题";

特殊情况：hook_form_alter阶段字段未生成的处理 #

部分内嵌实体会在表单构建的after_build阶段才生成字段结构，可通过添加after_build回调处理：

function custom_module_form_user_register_form_alter(&$form, FormStateInterface $form_state, $form_id) {
  $form['#after_build'][] = 'custom_module_after_build_user_register';
}

function custom_module_after_build_user_register(array $form, FormStateInterface $form_state) {
  // 在这里修改内嵌实体的字段属性，确保字段已生成
  $form['survey_participants_profiles'][0]['entity']['field_registration_code']['widget'][0]['value']['#title'] = "修改后的标题";
  return $form;
}

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