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 文件。
添加与提交
将需要上传的文件拖入本地仓库文件夹,执行以下命令:


