如何自动生成Flutter项目的预设文件夹、文件及通用代码？

针对你每次手动搭建Flutter项目架构耗时的问题，以下是几种实用的自动化方案：

1. 自定义Starter模板项目 #

• 先搭建一个符合你需求的标准项目骨架：包含constant、utils等固定文件夹，写好错误页面、加载组件等通用代码，配置好常用依赖。
• 将这个项目保存为本地模板，每次启动新项目时，直接复制模板文件夹，重命名后修改项目名称、包名等关键信息即可。
• 进阶用法：把自定义模板集成到Flutter的官方模板体系中，找到Flutter安装目录下的packages/flutter_tools/templates/app，复制一份修改成你的专属模板，之后用flutter create --template=你的模板名 新项目名就能一键生成带完整架构的项目。

2. 编写命令行脚本一键生成 #

• 用Shell（Linux/macOS）或Batch（Windows）脚本自动化创建文件夹、文件并写入通用代码，示例Shell脚本如下：

#!/bin/bash
if [ -z "$1" ]; then
  echo "请输入项目名称"
  exit 1
fi

PROJECT_NAME=$1

# 创建基础Flutter项目
flutter create $PROJECT_NAME
cd $PROJECT_NAME

# 创建核心文件夹结构
mkdir -p lib/constant lib/utils lib/widgets/common lib/services

# 生成常量文件
cat > lib/constant/app_constants.dart << EOF
class AppConstants {
  static const String appName = '$PROJECT_NAME';
  static const int timeout = 30;
  // 可添加更多通用常量
}
EOF

# 生成错误页面组件
cat > lib/widgets/common/error_page.dart << EOF
import 'package:flutter/material.dart';

class ErrorPage extends StatelessWidget {
  final String errorMessage;
  final VoidCallback? onRetry;

  const ErrorPage({
    super.key,
    required this.errorMessage,
    this.onRetry,
  });

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text(errorMessage, style: const TextStyle(fontSize: 16)),
            if (onRetry != null)
              ElevatedButton(
                onPressed: onRetry,
                child: const Text('重试'),
              ),
          ],
        ),
      ),
    );
  }
}
EOF

echo "项目架构生成完成"

• 保存脚本为create_flutter_project.sh，赋予执行权限后，运行./create_flutter_project.sh 新项目名就能一键完成架构搭建。

3. IDE模板与代码片段 #

• VS Code：通过文件 > 首选项 > 用户代码片段添加常用组件的代码模板，比如输入errorpage就能快速生成错误页面的完整代码；也可以安装支持自定义项目模板的插件，新建项目时直接选择你的预设模板。
• Android Studio/IntelliJ：通过文件 > 新建 > 编辑文件模板自定义文件模板，创建constant、utils类时直接选择模板生成基础内容；也可以创建项目模板，新建项目时直接套用。

4. 代码生成工具（适合复杂场景） #

• 使用build_runner配合source_gen自定义代码生成器，通过注解或配置文件生成通用代码和文件夹结构。比如定义一个注解，运行flutter pub run build_runner build就能自动生成所需的常量类、基础组件等。这种方式适合需要动态调整架构的复杂场景。

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