GitHub 项目上传实战指南
Git 与 GitHub 简介
Git 是一个免费的开源分布式版本控制系统，用于跟踪文件变更。它允许开发者将更改添加到代码中，并在准备好时提交保存，随时可回溯历史。GitHub 则是基于 Git 的代码托管平台，提供仓库用于存放项目。作为免费开源系统，GitHub 支持公开资料共享和私有付费仓库，具备优秀的代码管理能力。
环境准备与配置
安装 Git
访问官网下载并安装 Git，全程点击下一步即可。安装完成后，在桌面或文件夹右键应能看到 Git Bash 选项，这是后续操作的主要命令行工具。
注意：Git 默认编辑器为 Vim，操作逻辑与传统编辑器不同。若误入编辑模式无法退出，可按
Shift+;(即:) +q+Enter退出；强制终止运行可使用Ctrl+C。
初始化用户信息
提交前需配置用户名和邮箱，否则会出现问题。推荐直接在命令行执行以下命令（替换为你的真实信息）：
git config --global user.email "[email protected]"
git config --global user.name "yourname"
也可手动修改 .git/config 文件添加 [user] 段落。
远程仓库创建
- 登录 GitHub 个人主页，点击右上角加号选择 New repository。
- 填写仓库名称、描述，勾选 Initialize this repository with a README（建议勾选以便后续分支处理）。
- 点击 Create repository。
创建成功后，页面会显示 HTTP 或 SSH 链接，复制该地址备用。同时留意主分支名称，新版 GitHub 默认为 main，旧版可能为 master，这关系到后续推送是否成功。
本地仓库关联
初始化本地仓库
在本地创建一个专门管理项目的文件夹（避免使用中文路径），进入后右键打开 Git Bash，执行初始化：
git init
此时文件夹下会生成隐藏的 .git 目录，表示本地仓库已就绪。
连接远端
使用上一步获取的链接关联远程仓库：
git remote add origin [你的 HTTP 或 SSH 链接]
若无输出通常代表成功。此时需注意分支名称匹配问题，如果本地是 master 而远端是 main，直接推送可能会失败，需要切换分支。
首次上传流程
切换分支
检查当前分支状态：
git branch -a
若发现只有 master 而远端是 main，需拉取并切换：
git fetch
git checkout main
切换成功后，本地文件夹内会出现远程的 README 文件。
添加与提交
将需要上传的文件拖入本地仓库文件夹，执行以下命令：
