要将本地的项目文件夹同步到GitHub，主要分为几个步骤：准备环境、初始化本地仓库、关联远程仓库、进行首次推送。整个流程的概览图如下：

🔧 第一步：安装与配置Git

如果你的电脑还没有安装Git，需要先下载安装。完成后，打开命令行终端（如Git Bash、CMD或终端），配置你的用户名和邮箱，这样你的提交记录才会带有身份信息

📁 第二步：在项目文件夹初始化本地仓库

1. 打开终端，使用 cd 命令进入你的项目文件夹。

2. 执行以下命令，将该文件夹初始化为一个Git仓库。这会在文件夹内创建一个隐藏的 .git 目录

3. 

🖥️ 第三步：在GitHub上创建远程仓库

1. 登录你的GitHub账号。

2. 点击页面右上角的 “+” 号，选择 “New repository”。

3. 填写仓库名称，选择公开（Public）或私有（Private）。

4. 关键点：不要勾选 “Add a README” 或 “Initialize with .gitignore” 等选项，因为你已经有了一个现成的本地项目，直接初始化会引发冲突。

5. 点击 “Create repository” 完成创建。

🔗 第四步：关联本地仓库与远程仓库

创建成功后，GitHub会显示一个仓库地址（HTTPS或SSH格式）。在终端中执行以下命令，将本地仓库与这个远程地址关联起来。通常远程仓库的默认名称为 origin

你也可以使用以 git@github.com: 开头的SSH地址。SSH方式通常更安全，且无需每次输入密码，但需要预先配置SSH密钥

📤 第五步：提交代码并推送到GitHub

将文件添加到暂存区：使用以下命令添加文件夹内的所有文件（. 代表当前目录所有文件）

提交到本地仓库：为这次提交添加一个说明信息。

推送到远程仓库：这是最关键的一步，将本地提交推送到GitHub。-u 参数用于建立本地当前分支与远程分支的跟踪关联。

！注意事项

• 推送失败（认证失败）：如果使用HTTPS链接，GitHub已不再支持使用账户密码推送，需要创建并使用个人访问令牌作为密码。或者，配置SSH密钥是更推荐的一劳永逸的方法。如何配置SSH密钥：https://blog.csdn.net/qq_57126168/article/details/155455742?fromshare=blogdetail&sharetype=blogdetail&sharerId=155455742&sharerefer=PC&sharesource=qq_57126168&sharefrom=from_link

• 推送失败（远程有变更）：如果远程仓库（如GitHub上）在你之后有了新的提交，直接推送会失败。你需要先执行 git pull 拉取远程变更并合并到本地，解决可能的冲突后，再执行 git push。