使用 Git 将本地项目上传至 GitHub

填写内容如下。

第三步： 点击最下方创建仓库。

创建完毕后，可见 README 文件、仓库名及描述。注意左侧的 main 是主分支名字，连接远端仓库时需注意。右侧 Branch 处可创建分支，但建议先使用 Git 命令行在本地创建，避免影响提交记录显示。

右边部分可获得 HTTP 链接或 SSH 链接，稍后会用到。

3. 本地仓库的关联

开始本地仓库创建与关联。

第一步： 创建文件夹并命名，切记不要带汉字。

第二步： 进入文件夹右击，点击 Git Bash 工具。

弹出窗口可能涉及 Vim 编辑器。若不小心进入 Vim 界面无法退出，可使用快捷键退出。

Vim 编辑器操作说明：

1. 退出 Vim 编程界面：输入 Shift+: 然后输入 q 再按 Enter。
2. 退出 Vim 窗口：快捷键 Ctrl+D 或点击右上角 X 号。
3. 强制终止运行：若卡住，使用 Ctrl+C。
4. 命令回溯：使用上下方向键查看历史命令。

第三步： 输入 git init 初始化仓库，生成 .git 文件。

git init 

输出代表成功。若无成功提示可重试。

第四步： 检查文件夹下是否显示 .git 文件夹，若未显示需开启隐藏文件。

第五步： 配置 config 文件。双击用记事本打开 config 文件，添加以下内容：

[user]
	name = yourname
	email = [email protected]

保存后建议隐藏 .git 文件。

方法 2：直接在命令行输入：

git config --global user.email "[email protected]"
git config --global user.name "yourname"

第六步： 链接远端仓库。

git remote add origin [http 地址]

复制前文获得的 HTTP 地址粘贴运行。无输出通常表示正确。

注意：远端仓库默认分支可能是 main，而本地初始化为 master，后续需切换分支以避免冲突。

4. 项目的首次上传

第一步： 切换分支。

1. 查看分支：

git branch -a 

2. 拉取远端仓库：

git fetch 

若显示 new branch main，继续下一步。若网络不稳定导致失败，可稍后重试。

3. 切换分支：

git checkout main 

切换成功后文件夹中会显示 README 文件。

第二步： 添加文件。

将需要上传的文件拖入本地仓库文件夹。初次上传可先传一个文件。

git add .

. 前需加空格，代表加入当前文件夹下所有文件。也可指定文件名：

git add file.c 

使用 git status 查看状态。

第三步： 提交文件。

git commit -m "这是你的提交说明"

第四步： 推送到远端仓库。

第一次推送需指定参数：

git push -u origin main 

输出成功提示即表示完成。刷新 GitHub 仓库页面可查看文件。

5. 上传时的常见错误

除命令行方式外，GitHub 也提供图形界面上传方式。建议互联网相关工作者优先掌握命令行操作。若对其他方法感兴趣，可查阅官方文档或社区资源。