Git是一个开源的分布式版本控制系统，用于跟踪代码的更改。它允许开发者在本地进行代码开发，然后将更改同步到远程仓库，如GitHub。以下是如何使用Git将本地代码上传到GitHub的详细步骤，包括示例和注释：

1. 安装Git

从git官网下载安装。

2. 创建GitHub仓库

在GitHub上创建一个新的仓库。登录GitHub，点击右上角“+”号，然后选择“New repository”。设置然后点击“Create repository”。

3. 配置Git

打开终端或命令提示符，配置Git用户名和邮箱地址。这些信息将用于标识之后的提交。

git config --global user.name "Your Name"  
git config --global user.email "your.email@example.com"

4. 初始化本地仓库

在项目文件夹中初始化一个新的Git仓库。

cd your-project-folder  # 进入你的项目文件夹  
git init  # 初始化Git仓库

5. 添加文件到暂存区

使用git add命令将你想要上传的文件或文件夹添加到暂存区。

git add .  # 添加所有文件到暂存区  
# git add file1.txt file2.txt  # 或者添加特定文件  

6. 提交更改

使用git commit命令，并添加一条描述性的提交信息。

***第5-6步都是在本地进行的***

git commit -m "Initial commit with project files"  # 提交更改并添加提交信息

7. 添加远程仓库地址

将你的本地仓库与GitHub上的远程仓库关联起来。在GitHub仓库页面，找到并复制仓库的URL。

git remote add origin "your-repository-url"  # 将远程仓库命名为origin，并设置URL

8. 推送到远程仓库

使用git push命令将本地c更改推送到远程仓库。

git push -u origin master  # 将更改推送到名为origin的远程仓库的master分支  
# 如果使用main作为默认分支，则命令应为：  
git push -u origin main

注意：
分支在Git等版本控制系统中，指的是从主要代码线（如主分支或开发分支）分出来的一条独立发展的代码线。每个分支都代表了一种独立的开发线，可以在不影响其他分支的情况下进行开发和测试。当开发完成后，可以将分支合并回主分支或其他分支，以实现代码的整合和共享。

上面代码中的 -u 用于设置上游（upstream）跟踪分支，这样Git会将本地分支与指定的远程分支进行关联，并设置为上游跟踪分支。这样在未来的 git pull 和 git push 命令中，Git会自动使用这个关联信息进行交互，无需再次指定远程仓库和分支名称。

例如，如果执行了git push -u origin feature-branch命令将本地分支feature-branch推送到远程仓库origin的同名分支，并设置为上游跟踪分支。那么在未来执行git pull命令时，Git会自动从origin/feature-branch拉取更新到本地feature-branch分支；执行git push命令时，Git会自动将本地feature-branch分支的更新推送到origin/feature-branch分支。

ps：

github上如何查看现有分支

1. 通过GitHub网站界面查看

1. 打开GitHub，并登录。
2. 导航到仓库页面。
3. 在仓库页面上方，有一行选项卡，其中包括“Code”、“Issues”、“Pull requests”等。
4. 点击“Branches”选项卡。
5. 在这个页面上，你将看到该仓库中所有分支的列表。

2. 使用Git命令行工具查看

如果已经在本地克隆了仓库，可以使用Git命令行工具来查看远程仓库的分支。

git remote update      # 更新远程仓库信息  
git branch -r          # 查看远程分支列表

3. 使用Git图形界面客户端查看