1. 为什么需要Git上传文件夹到GitHub？
作为一名开发者，我经常需要将本地项目备份到云端或者与他人协作开发。GitHub作为全球最大的代码托管平台，提供了完美的解决方案。但很多新手在第一次使用Git上传文件夹时总会遇到各种问题，比如：
- 不知道如何初始化本地仓库
- 上传后发现文件夹结构混乱
- 不小心上传了不必要的文件
- 遇到权限问题无法推送
这些问题我都曾经历过，今天我就把我的经验总结成这篇详细的教程，手把手教你如何正确上传文件夹到GitHub。
2. 环境准备与基础配置
2.1 Git安装与配置
首先，我们需要安装Git工具。根据我的经验，Windows用户最好选择Git for Windows，它包含了Git Bash这个强大的命令行工具。
安装完成后，打开Git Bash（Windows）或终端（Mac/Linux），进行基础配置：
git config --global user.name "你的GitHub用户名" git config --global user.email "你的GitHub注册邮箱"提示：这里的用户名和邮箱必须与你的GitHub账号一致，否则贡献统计会出错。
2.2 创建GitHub仓库
登录GitHub，点击右上角的"+"号选择"New repository"。这里有几个关键设置需要注意：
- Repository name：建议与本地文件夹同名
- Public/Private：根据项目性质选择
- Initialize this repository with：不要勾选任何选项
创建完成后，记下仓库的HTTPS或SSH地址，我们后面会用到。
3. 本地项目初始化与上传
3.1 初始化本地Git仓库
进入你要上传的文件夹，右键选择"Git Bash Here"（Windows）或在终端中导航到该目录（Mac/Linux）。
执行以下命令初始化本地仓库：
git init这个命令会在你的文件夹中创建一个隐藏的.git目录，用于存储版本控制信息。
3.2 创建.gitignore文件
这是很多新手会忽略的重要步骤。.gitignore文件告诉Git哪些文件不需要上传。根据我的经验，至少应该忽略：
- 操作系统生成的文件（如.DS_Store、Thumbs.db）
- 编辑器配置文件（如.idea、.vscode）
- 依赖目录（如node_modules）
- 敏感信息（如.env、*.key）
创建一个.gitignore文件并添加以下内容：
# 操作系统文件 .DS_Store Thumbs.db # 编辑器文件 .idea/ .vscode/ # 依赖目录 node_modules/ # 环境变量 .env3.3 添加文件到暂存区
使用以下命令将所有文件添加到暂存区：
git add .如果想查看哪些文件将被提交，可以使用：
git status3.4 提交更改
提交更改到本地仓库：
git commit -m "Initial commit"提示：提交信息应该简洁明了，描述这次提交的主要内容。
4. 连接远程仓库并推送
4.1 添加远程仓库地址
将本地仓库与GitHub上的远程仓库关联：
git remote add origin 你的GitHub仓库地址如果是HTTPS地址，格式类似：
git remote add origin https://github.com/用户名/仓库名.git如果是SSH地址，格式类似：
git remote add origin git@github.com:用户名/仓库名.git4.2 推送代码到GitHub
最后一步，将本地代码推送到GitHub：
git push -u origin master注意：GitHub现在默认分支是main，如果你的本地分支是master，可能会遇到问题。可以使用
git branch -M main将分支重命名为main，然后再推送。
5. 常见问题与解决方案
5.1 推送被拒绝
错误信息：
! [rejected] master -> master (non-fast-forward)解决方案：
git pull --rebase origin master git push -u origin master5.2 大文件上传失败
GitHub对单个文件大小有限制（100MB）。如果遇到这个问题：
- 安装Git LFS：
git lfs install- 跟踪大文件：
git lfs track "*.psd"- 重新提交并推送
5.3 认证失败
如果使用HTTPS协议推送时要求反复输入用户名密码，可以改用SSH协议或者配置Git凭证存储：
git config --global credential.helper store6. 高级技巧与最佳实践
6.1 分支管理策略
我建议采用Git Flow工作流：
- master/main：稳定版本
- develop：开发分支
- feature/xxx：功能分支
- hotfix/xxx：紧急修复分支
创建新分支：
git checkout -b feature/new-feature6.2 提交规范
遵循Angular提交规范，格式为：
<type>(<scope>): <subject>常用type：
- feat：新功能
- fix：修复bug
- docs：文档变更
- style：代码格式
- refactor：重构代码
6.3 使用GitHub Desktop
对于不熟悉命令行的用户，GitHub Desktop提供了图形化界面，可以简化上传流程：
- 下载安装GitHub Desktop
- 选择"Add existing repository"
- 选择你的本地文件夹
- 点击"Publish repository"
7. 实际案例演示
让我们以一个React项目为例，完整演示上传过程：
- 创建React项目：
npx create-react-app my-app cd my-app- 初始化Git仓库：
git init- 创建.gitignore：
node_modules/ .env build/ .DS_Store- 添加并提交：
git add . git commit -m "Initial commit"- 连接GitHub并推送：
git remote add origin git@github.com:username/my-app.git git push -u origin main8. 维护与更新项目
当项目有更新时，使用以下工作流：
- 拉取最新代码：
git pull origin main- 创建新分支开发：
git checkout -b feature/awesome-feature- 开发完成后提交：
git add . git commit -m "feat: add awesome feature"- 推送到远程：
git push origin feature/awesome-feature- 在GitHub上创建Pull Request
9. 团队协作注意事项
在团队协作中，有几个关键点需要注意：
- 每次开始工作前先拉取最新代码：
git pull origin main- 解决冲突时保持沟通：
- 使用
git diff查看冲突 - 手动解决冲突后标记为已解决：
git add 冲突文件- 定期清理已合并的分支：
git branch -d 分支名 git push origin --delete 分支名10. 我的个人经验分享
经过多年的Git使用，我总结出以下几点经验：
提交频率要高，每次提交的变更要小。这样在出现问题时更容易定位和回退。
写有意义的提交信息。几个月后回头看时，你会感谢现在的自己。
善用
git stash暂存未完成的工作：
git stash git stash pop- 定期使用
git gc清理仓库：
git gc- 学习使用
git reflog找回丢失的提交：
git reflog git reset --hard HEAD@{n}Git是一个强大的工具，刚开始可能会觉得复杂，但一旦掌握，它会成为你开发工作中不可或缺的助手。希望这篇教程能帮助你顺利上传项目到GitHub，开启你的代码管理之旅。
