# flutter_init

**Repository Path**: flutter-tutorial/flutter_init

## Basic Information

- **Project Name**: flutter_init
- **Description**: Flutter项目初始化模板
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-09
- **Last Updated**: 2026-10-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# flutter_init

A new Flutter project.

## Getting Started

This project is a starting point for a Flutter application.

A few resources to get you started if this is your first Flutter project:

- [Lab: Write your first Flutter app](https://docs.flutter.dev/get-started/codelab)
- [Cookbook: Useful Flutter samples](https://docs.flutter.dev/cookbook)

For help getting started with Flutter development, view the
[online documentation](https://docs.flutter.dev/), which offers tutorials,
samples, guidance on mobile development, and a full API reference.

## 官方网站

国际站：[https://flutter.dev/](https://flutter.dev/)

中文站：[https://flutter.cn/](https://flutter.cn/)

## 环境搭建--windows系统

1. 软件要求
   - [Windows PowerShell](https://learn.microsoft.com/zh-cn/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.5) 7.5
   
   - [Git for Windows](https://git-scm.com/)

   - [Visual Studio Code](https://code.visualstudio.com/)

2. 在中国网络环境下单独配置镜像，具体参照文档：[在中国网络环境下使用 Flutter](https://docs.flutter.cn/community/china/)。
   - 配置 Flutter 镜像站点

     使用 Powershell 设置环境变量，管理员模式下运行下面的指令：

     ```
     [System.Environment]::SetEnvironmentVariable('PUB_HOSTED_URL', 'https://pub.flutter-io.cn', 'User')
     [System.Environment]::SetEnvironmentVariable('FLUTTER_STORAGE_BASE_URL', 'https://storage.flutter-io.cn', 'User')
     ```
    - 配置你的机器发布 package （后期使用）

3. 配置文本编辑器或 IDE
   
   经过测试最佳的编辑器按照推荐度排序：

   - [Android Studio](https://developer.android.com/studio/install?hl=zh-cn#windows)

   - [Visual Studio Code](https://code.visualstudio.com/)

   安装最新版 IDE，搭配 Flutter 插件，提供代码自动补全、语法高亮、widget 编写辅助、调试以及其他功能。

   此外，建议在上述 IDE 中安装 AI 编程插件，提供代码补全、智能问答、Agent 自动编码等能力。以下插件均提供 JetBrains 系（Android Studio）与 Visual Studio Code 两种插件形态，按个人习惯选用其一即可：

   | 插件 | 出品方 | 插件市场搜索名称 | IDE 版本要求 |
   | --- | --- | --- | --- |
   | [CodeBuddy](https://copilot.tencent.com/) | 腾讯云 | `CodeBuddy` | JetBrains 2022.2+ / VS Code 1.82+ |
   | [Qoder](https://qoder.cn/) | 阿里巴巴 | `Qoder CN`（国内版，原通义灵码）/ `Qoder`（国际版） | JetBrains 2020.3+ / VS Code 1.68+ |
   | [Trae Plugin](https://www.trae.cn/plugin) | 字节跳动 | `TRAE`（发布者 trae.ai，插件全称 TRAE AI: Coding Assistant） | JetBrains 2022.2+ / VS Code 1.93+ |

   **Android Studio 安装步骤**（JetBrains 系 IDE 通用）：

   1. 打开 `File → Settings`。
   2. 选择 `Plugins`，切换到 `Marketplace` 标签页。
   3. 搜索上表中的插件名称，选中后点击 `Install`。
   4. 安装完成后点击 `Restart IDE`，重启后点击侧边栏插件图标，按提示登录账号。

   **Visual Studio Code 安装步骤**：

   1. 按下 `Ctrl + Shift + X` 打开扩展视图，或点击左侧活动栏的扩展图标。
   2. 搜索上表中的插件名称，认准官方发布者后点击 `Install`。
   3. 安装完成后按提示重新加载窗口，点击侧边栏插件图标，按提示登录账号。

   > 建议只保留一个补全类 AI 插件，多个同时启用容易造成补全提示冲突；Trae Plugin 用于 VS Code 与 JetBrains IDE，与独立的 Trae IDE 是两种不同形态，任选其一即可。

4. 参照官方文档：[安装和搭建环境](https://docs.flutter.cn/get-started/install)

5. 上一步应该创建好了一个 Flutter 项目。

   如果没有创建，则按照下列步骤创建第一个 Flutter 项目：
   
   - 打开 命令面板 (Command Palette)，按下快捷键 Control + Shift + P。

   - 在 命令面板 (Command Palette) 中输入 flutter。

   - 选择 Flutter: New Project。

6. 配置 Android SDK 位置
     
   在 Powershell 中运行指令

    ```
    flutter config --android-sdk D:\Android\Sdk
    ```

7. 修改 gradle 的下载镜像源

   - 修改 `flutter_init\android\gradle\wrapper\gradle-wrapper.properties` 文件

    ```
    distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.10.2-all.zip
    ```

8. Maven 附加阿里云镜像源

   - 在 `flutter_init\android\build.gradle.kts` 文件附加阿里云镜像源

     ```
     allprojects {
        repositories {
            // 阿里云公共 Maven 仓库
            maven {
                url = uri("https://maven.aliyun.com/repository/public")
            }
            // 阿里云 Spring Maven 仓库
            maven {
                url = uri("https://maven.aliyun.com/repository/spring")
            }
            // 阿里云 Google Maven 仓库
            maven {
                url = uri("https://maven.aliyun.com/repository/google")
            }
            // 阿里云 Gradle 插件 Maven 仓库
            maven {
                url = uri("https://maven.aliyun.com/repository/gradle-plugin")
            }
            // 阿里云 Spring 插件 Maven 仓库
            maven {
                url = uri("https://maven.aliyun.com/repository/spring-plugin")
            }
            // 阿里云 Grails 核心 Maven 仓库
            maven {
                url = uri("https://maven.aliyun.com/repository/grails-core")
            }
            // 阿里云 Apache Snapshots Maven 仓库
            maven {
                url = uri("https://maven.aliyun.com/repository/apache-snapshots")
            }
            google()
            mavenCentral()
        }
     }
     ```

   - 在 `flutter_init\android\settings.gradle.kts` 文件附加阿里云镜像源

     ```
     repositories {
        // 阿里云公共 Maven 仓库
        maven {
            url = uri("https://maven.aliyun.com/repository/public")
        }
        // 阿里云 Spring Maven 仓库
        maven {
            url = uri("https://maven.aliyun.com/repository/spring")
        }
        // 阿里云 Google Maven 仓库
        maven {
            url = uri("https://maven.aliyun.com/repository/google")
        }
        // 阿里云 Gradle 插件 Maven 仓库
        maven {
            url = uri("https://maven.aliyun.com/repository/gradle-plugin")
        }
        // 阿里云 Spring 插件 Maven 仓库
        maven {
            url = uri("https://maven.aliyun.com/repository/spring-plugin")
        }
        // 阿里云 Grails 核心 Maven 仓库
        maven {
            url = uri("https://maven.aliyun.com/repository/grails-core")
        }
        // 阿里云 Apache Snapshots Maven 仓库
        maven {
            url = uri("https://maven.aliyun.com/repository/apache-snapshots")
        }
        google()
        mavenCentral()
        gradlePluginPortal()
     }
     ```
## 注意事项

如果clone本项目作为Flutter初始项目，请修改 `flutter_init\android\local.properties` 文件中下列配置：

```
# Android SDK 路径
sdk.dir=D:\\Android\\Sdk

# Flutter SDK 路径
flutter.sdk=D:\\flutter
```

## 推荐书籍

- [Flutter实战·第二版](https://book.flutterchina.club/)