以下是将本地代码文件夹创建为 Git 仓库并同步到 GitHub 的全过程步骤:
前提条件
- 确保在本地已安装 Git。
- 已注册 GitHub 账号,并且在 GitHub 上创建了一个新的仓库(可以是空仓库)。
步骤 1:在本地初始化 Git 仓库
-
打开终端或命令行,进入项目所在的目录:
cd /path/to/your/local/project
-
初始化 Git 仓库:
git init
这将创建一个隐藏的
.git
文件夹,Git 会用它来管理项目的版本控制。
步骤 2:添加文件到 Git 仓库
-
查看当前文件状态:
git status
这将显示所有未被跟踪的文件。
-
将文件添加到 Git 暂存区:
git add .
.
表示将所有文件添加到暂存区。你也可以用git add filename
来添加特定文件。 -
提交文件:
git commit -m "Initial commit"
-m
用于提供简短的提交信息,例如"Initial commit"
。
步骤 3:创建远程仓库
-
在 GitHub 上创建一个新的仓库:
- 进入 GitHub。
- 点击右上角的
+
图标,选择 “New repository”。 - 输入仓库名称和其他选项。
- 注意:保持仓库为空,不要添加
README.md
或.gitignore
文件。
-
复制仓库的 HTTPS 或 SSH 链接:
例如,HTTPS 链接类似于:
https://github.com/username/repository.git
步骤 4:将本地仓库与 GitHub 仓库关联
-
添加远程仓库地址:
git remote add origin https://github.com/username/repository.git
将
https://github.com/username/repository.git
替换为你的 GitHub 仓库链接。 -
验证远程仓库:
git remote -v
输出应包含
origin
的远程地址,说明关联成功。
步骤 5:推送本地仓库到 GitHub
-
设置默认分支
git branch -M main
-
推送代码到 GitHub 仓库:
git push -u origin main
-u
表示将本地的main
分支与远程的origin
仓库关联。origin
是远程仓库的名称(默认名称为origin
)。main
是推送的分支名称。可以用git branch
检查分支名称。
注意:第一次推送时可能会提示输入 GitHub 的用户名和密码。
步骤 6:验证推送结果
-
登录 GitHub 并进入仓库,刷新页面,查看是否成功上传了本地代码。
-
确认代码已成功上传,包含初始提交的信息和文件结构。
补充说明
-
定期提交和推送:在开发过程中,可以通过以下命令定期提交更改:
git add . git commit -m "Your commit message" git push
-
生成 SSH 密钥:如果不想每次推送代码时输入用户名和密码,可以使用 SSH 方式。首先生成 SSH 密钥并添加到 GitHub:
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
然后将生成的公钥(
~/.ssh/id_rsa.pub
)添加到 GitHub 的 SSH Keys 中。