准备工作
作为开发者,将本地代码托管到远程仓库(如 GitHub)是版本控制的基本功。这不仅能备份代码,还能方便团队协作。本文介绍如何将已存在的本地项目,第一次完整上传到 GitHub 上的一个新的空白仓库。这与 git clone 从远程下载的操作正好相反。
在开始之前,请确保你已完成以下准备:
- 已安装 Git 并配置好用户信息(
git config --global user.name "Your Name"和git config --global user.email "[email protected]")。 - 拥有有效的 GitHub 账号。
初始化本地仓库
首先,打开命令行终端(如 Git Bash、CMD 或 PowerShell),进入你的项目根目录。注意不要进入子文件夹,而是项目最外层的根目录。
cd /path/to/your/project
# 例如:cd E:\A-Auto-yu\AUTO-yu
确认路径无误后,执行初始化命令:
git init
这会创建一个隐藏的 .git 文件夹,标志着当前目录已成为一个 Git 仓库。
添加并提交代码
接下来将文件纳入版本管理。使用 . 表示当前目录下所有文件和子目录:
git add .
执行后可用 git status 查看哪些文件已进入暂存区(通常显示为绿色)。随后提交到本地历史记录:
git commit -m "Initial commit"
这里的 -m 参数用于编写提交说明,建议简明扼要地描述本次改动,例如'首次提交项目代码'。至此,本地仓库已就绪。
创建远程仓库
登录 GitHub,点击右上角的 "+" 号选择 "New repository"。填写仓库名称(建议与本地项目名相关),选择公开或私有权限。关键步骤: 不要勾选 "Add a README file"、"Add .gitignore" 或 "Choose a license"。因为我们已有本地代码,需要的是一个完全空白的仓库来接收推送。
点击 "Create repository" 后,GitHub 会展示连接本地仓库的指令,稍后会用到这些信息。




