Windows 小白从 0 到 1：创建 GitHub 仓库、安装 Git、配置账号、SSH 连接并上传 Flutter 项目（一次成功）

> 适合人群：
> 
> * Windows 用户
> * 完全不会 Git / GitHub
> * 有一个 Flutter 项目想上传到 GitHub
> 
> 本文目标：**从“什么都不会”到“成功用 SSH 把 Flutter 项目推送到 GitHub”**，中间每一步都解释“为什么要这么做”，并覆盖 90% 新手会踩的坑。

* * *

## 一、先搞清楚 3 个核心概念（非常重要）

### 1. Git 是什么？

**Git 是一个“代码版本管理工具”**，负责：

* 记录每一次代码修改
* 可以回滚历史
* 可以和别人协作

👉 Git **运行在你本地电脑上**。

* * *

### 2. GitHub 是什么？

**GitHub 是一个放 Git 仓库的网站**：

* 用来保存代码的“云端仓库”
* 也是程序员协作平台

👉 GitHub **在云端**。

* * *

### 3. 本地仓库 vs 远程仓库

| 名称  | 在哪  | 作用  |
| --- | --- | --- |
| 本地仓库 | 你的电脑 | 用 Git 管理代码 |
| 远程仓库 | GitHub | 云端备份 & 协作 |

* * *

## 二、第一步：创建 GitHub 仓库（远程仓库）

### 2.1 登录 GitHub

打开 GitHub 官网（自行搜索，避免钓鱼网站），登录你的账号。

* * *

### 2.2 创建仓库（Repository）

右上角 `+` → **New repository**

推荐填写：

* **Repository name**：`my_flutter_app`
* **Public / Private**：随意
* ✅ 勾选 `Add a README file`（强烈建议）
* 其他选项先不管

点击 **Create repository**。

* * *

### 2.3 复制 SSH 仓库地址（后面会用）

进入仓库页面 → 点击绿色 **Code** → 切换到 **SSH**

你会看到类似：

    git@github.com:你的用户名/my_flutter_app.git

👉 **复制保存好**。

* * *

## 三、第二步：在 Windows 上安装 Git（关键一步）

### 3.1 下载 Git for Windows

搜索并下载 **Git for Windows**（官网）。

* * *

### 3.2 安装时的关键选项（新手必看）

安装过程中注意这两点：

1️⃣ **Adjusting your PATH environment**请选择：

> ✅ Git from the command line and also from 3rd-party software

2️⃣ 其他选项：**全部默认，一路 Next**

* * *

### 3.3 验证 Git 是否安装成功

安装完成后：

* 右键 → **Git Bash Here**
* 输入：

    git --version

能看到版本号，说明安装成功。

* * *

## 四、第三步：配置 Git 身份（不配一定会报错）

Git 每次提交代码，都需要知道“是谁提交的”。

### 4.1 设置用户名和邮箱

在 **Git Bash** 中执行（换成你自己的）：

    git config --global user.name "你的名字"
    git config --global user.email "你的邮箱"

示例：

    git config --global user.name "xiaobai"
    git config --global user.email "xiaobai@qq.com"

* * *

### 4.2 检查是否配置成功

    git config --global --list

看到 `user.name` 和 `user.email` 即可。

* * *

## 五、第四步：配置 SSH（最容易卡人的一步，但只需一次）

> SSH 的作用：**以后 push 代码，不用再输入账号密码**。

* * *

### 5.1 检查是否已有 SSH Key

    ls -al ~/.ssh

* 如果有 `id_ed25519` 和 `id_ed25519.pub` → 可以直接用
* 如果没有 → 继续下一步

* * *

### 5.2 生成 SSH Key（推荐 ed25519）

    ssh-keygen -t ed25519 -C "你的邮箱"

一路回车即可（新手**不要设置密码**，减少复杂度）。

* * *

### 5.3 启动 ssh-agent 并加载 Key

    eval "$(ssh-agent -s)"
    ssh-add ~/.ssh/id_ed25519

* * *

### 5.4 复制公钥内容

    cat ~/.ssh/id_ed25519.pub

👉 **复制全部内容**（以 `ssh-ed25519` 开头）。

* * *

### 5.5 在 GitHub 添加 SSH Key

GitHub → 头像 → **Settings** → **SSH and GPG keys** → **New SSH key**

* Title：`my-windows`
* Key：粘贴刚才复制的内容
* 保存

* * *

### 5.6 测试 SSH 是否配置成功（必须成功）

    ssh -T git@github.com

第一次输入 `yes` 回车。

成功标志：

    Hi xxx! You've successfully authenticated...

* * *

## 六、第五步：准备 Flutter 项目的 .gitignore（避免上传垃圾）

进入你的 **Flutter 项目根目录**（有 `pubspec.yaml` 的那一层）。

### 6.1 检查是否有 `.gitignore`

    ls

一般 Flutter 项目自带，如果没有，需要自己建。

* * *

### 6.2 常见 Flutter 忽略项（示例）

    .dart_tool/
    .packages
    .pub-cache/
    build/
    
    .idea/
    .vscode/
    
    .DS_Store
    
    android/.gradle/
    ios/Pods/

* * *

## 七、第六步：把 Flutter 项目变成 Git 仓库（本地）

    cd 你的_flutter_项目路径
    git init

查看状态：

    git status

* * *

## 八、第七步：首次提交代码（Commit）

### 8.1 添加所有文件

    git add .

### 8.2 提交

    git commit -m "init flutter project"

* * *

## 九、第八步：绑定 GitHub 仓库并推送（Push）

### 9.1 添加远程仓库（SSH）

    git remote add origin git@github.com:你的用户名/my_flutter_app.git

验证：

    git remote -v

* * *

### 9.2 统一主分支名为 main

    git branch -M main

* * *

### 9.3 首次推送

    git push -u origin main

成功后，刷新 GitHub 页面，你的 Flutter 项目就出现了 🎉

* * *

## 十、新手最常见错误合集（直接对照）

### 10.1 Permission denied (publickey)

* SSH Key 没加到 GitHub
* ssh-agent 没加载 key

解决：

    ssh-add -l
    ssh-add ~/.ssh/id_ed25519

* * *

### 10.2 仓库不存在 / not found

* 仓库名拼错
* 用户名拼错
* 私有仓库无权限

* * *

### 10.3 `.DS_Store`、`build/` 已经被提交

    git rm -r --cached build .dart_tool
    git add .
    git commit -m "chore: update gitignore"
    git push

* * *

## 十一、以后日常只用这 4 个命令

    git status
    git add .
    git commit -m "说明这次改了什么"
    git push

* * *

## 十二、总结（给 Windows 小白）

* Git：本地管理代码
* GitHub：云端仓库
* SSH：一次配置，终身省事
* Flutter 项目：记得 `.gitignore`

👉 **只要这套流程走通一次，以后就是重复动作。**