Flutter自定义Arima字体不生效，请求排查解决

问题描述 #

我正在学习Flutter，按照教程配置了自定义字体Arima，已在代码中指定Text组件使用该字体，并在pubspec.yaml中完成字体配置，但字体未发生变化。参考了多个YouTube视频教程操作，问题仍未解决，恳请帮忙排查原因。

代码示例：

import 'package:flutter/material.dart';

void main() {
  runApp(
    MaterialApp(
      home: Scaffold(
        body: SafeArea(
            child: Center(
          child: Container(
            child: const Text(
              'you talk of the pain like it is all alright',
              style: TextStyle(
                fontFamily: 'Arima',
                fontSize: 20.0,
              ),
            ),
          ),
        )),
      ),
    ),
  );
}

pubspec.yaml配置示例：

# To add custom fonts to your application, add a fonts section here,
  # in this "flutter" section. Each entry in this list should have a
  # "family" key with the font family name, and a "fonts" key with a
  # list giving the asset and other descriptors for the font. For
  # example:
  fonts:
    - family: Arima
      fonts:
        - asset: fonts/Arima-Regular.ttf
  #      - asset: fonts/Arima-Italic.ttf

  #         style: italic
  #   - family: Trajan Pro
  #     fonts:
  #       - asset: fonts/TrajanPro.ttf
  #       - asset: fonts/TrajanPro_Bold.ttf
  #         weight: 700
  #
  # For details regarding fonts from package dependencies,
  # see https://flutter.dev/custom-fonts/#from-packages

排查步骤 #

• 检查字体文件路径与名称
  确认项目根目录下存在fonts文件夹，且内部的字体文件名完全匹配配置中的Arima-Regular.ttf，注意大小写（Linux/macOS系统区分大小写，Windows不区分，但统一保持一致更稳妥），路径使用正斜杠/。

• 校验pubspec.yaml缩进格式
  Flutter配置文件对缩进要求严格，fonts节点必须嵌套在flutter:层级下，且每个子节点的缩进要与同级配置保持一致。正确的缩进示例：

  flutter:
    uses-material-design: true
    fonts:
      - family: Arima
        fonts:
          - asset: fonts/Arima-Regular.ttf
  

  如果缩进错误，Flutter会忽略该配置项。

• 清理缓存并重启应用
  执行flutter clean清理项目缓存，然后重新运行flutter run，不要使用热重载（热重载不会重新加载资源文件）。

• 确认字体内部的家族名称
  部分字体文件的内部家族名称与文件名不一致，比如文件名是Arima-Regular.ttf，但字体内部的家族名可能是Arima Regular。可以用系统自带的字体查看工具（Windows字体查看器、Mac Font Book）打开ttf文件，查看其“字体家族”名称，然后将TextStyle中的fontFamily改为这个名称。

• 测试其他字体验证配置流程
  换一个已知可用的字体（比如Google Fonts中的Roboto），按照相同步骤配置，若能正常显示，说明原Arima字体文件可能损坏或格式不兼容，重新下载官方字体文件再尝试。

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