如何在Flutter整洁架构中按功能拆分ARB本地化文件？

1. 是否可将.arb翻译文件拆分至各功能的presentation文件夹？ #

完全可以。Flutter的本地化工具链支持指定多路径ARB文件，只需在项目根目录的l10n.yaml配置文件中，通过sources字段声明所有功能专属ARB文件的位置即可。

示例配置（l10n.yaml）：

sources:
  - lib/features/**/presentation/l10n/*.arb
  # 若有通用翻译文件，可同时添加根目录下的共享路径
  - lib/shared/l10n/*.arb
output-localization-file: app_localizations.dart
output-class: AppLocalizations

其中**是通配符，会递归扫描所有features下l10n文件夹中的ARB文件。

2. 将ARB文件置于功能专属文件夹是否仍能保证本地化逻辑正常运行，或存在管理局限？ #

正常运行的前提

只要l10n.yaml配置正确，Flutter Intl工具会自动扫描所有指定路径的ARB文件，合并生成统一的AppLocalizations类，本地化逻辑完全不受影响。

需要注意的管理局限

• 键名冲突：不同功能的ARB文件若使用相同键名，会导致翻译覆盖。解决方式是给每个功能的键名添加专属前缀，比如feature1_homeTitle、feature2_settingsLabel。
• 共享翻译维护：通用文本（如"确认""取消"这类全局按钮文本）若分散在各个功能文件中，会导致重复维护。建议将这类通用翻译单独放在根目录的shared/l10n文件夹中。
• 批量翻译协作：若需将翻译文件导出给外部人员，分散的文件会增加收集成本。可编写简单的Shell/Python脚本，将所有ARB文件按语言合并成单个文件，翻译完成后再拆分回对应路径。
• 团队上手成本：需确保团队成员熟悉l10n.yaml的配置逻辑，避免因路径配置错误导致翻译不生效。

3. 整洁代码架构下处理功能化本地化的推荐实践或工具有哪些？ #

推荐实践

• 严格分层：本地化逻辑仅允许在presentation层使用，domain和data层保持纯业务逻辑，不依赖任何UI或本地化相关代码，符合整洁架构的隔离原则。
• 键名规范：统一采用[功能标识]_[用途]的命名规则，比如checkout_formName、profile_editAvatar，既避免冲突，又能快速定位翻译所属功能。
• 分层管理翻译：
  • 全局通用翻译：放在lib/shared/l10n下，统一维护通用文本、错误提示等。
  • 功能专属翻译：放在对应feature的presentation/l10n下，仅包含该功能特有的文本。
• 避免硬编码：所有用户可见文本必须通过AppLocalizations类获取，禁止在代码中直接写死字符串。

推荐工具

• Flutter Intl插件：官方提供的VS Code/Android Studio插件，支持自动扫描配置路径下的ARB文件，生成对应的本地化类，还能实时预览翻译效果。
• ARB辅助脚本：自行编写简单脚本，实现批量合并/拆分ARB文件、检查键名冲突等功能，优化翻译协作流程。
• ARB Lint工具：通过custom_lint包自定义lint规则，检查代码中是否存在硬编码字符串、未使用的翻译键等问题。

示例项目结构 #

lib/
  ├── features/
  │    ├── checkout/
  │    │    ├── data/
  │    │    ├── domain/
  │    │    ├── presentation/
  │    │    │    └── l10n/
  │    │    │         ├── checkout_en.arb
  │    │    │         └── checkout_de.arb
  │    ├── profile/
  │    │    ├── ...
  │    │    ├── presentation/
  │    │    │    └── l10n/
  │    │    │         ├── profile_en.arb
  │    │    │         └── profile_de.arb
  ├── shared/
  │    └── l10n/
  │         ├── common_en.arb
  │         └── common_de.arb
  └── main.dart

示例ARB文件与使用 #

checkout_en.arb内容：

{
  "checkout_title": "Checkout",
  "checkout_submitOrder": "Submit Order"
}

common_en.arb内容：

{
  "btn_back": "Back",
  "btn_confirm": "Confirm"
}

在Widget中使用：

import 'package:flutter_gen/gen_l10n/app_localizations.dart';

class CheckoutScreen extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    final l10n = AppLocalizations.of(context)!;
    return Scaffold(
      appBar: AppBar(title: Text(l10n.checkout_title)),
      body: ElevatedButton(
        onPressed: () {},
        child: Text(l10n.checkout_submitOrder),
      ),
    );
  }
}

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