将本地工程上传到 GitHub 仓库的步骤如下
将本地工程上传到 GitHub 仓库的步骤如下
1. 创建 GitHub 仓库
- 登录 GitHub 账号
- 点击右上角 “+” 号,选择 “New repository”
- 填写仓库名称,选择公开或私有
- 不要初始化 README、.gitignore 或 license(如果本地已有项目)
- 点击 “Create repository”
2. 初始化本地 Git 仓库(如果尚未初始化)
# 进入项目目录
cd your-project-folder# 初始化 Git 仓库
git init
3. 添加文件到暂存区
# 添加所有文件
git add .# 或者添加特定文件
git add filename
4. 提交文件
# 提交文件并添加提交信息
git commit -m "Initial commit"
5. 连接远程仓库
# 将本地仓库与远程仓库关联
# 替换为你的实际仓库地址
git remote add origin https://github.com/your-username/your-repository-name.git
6. 推送到 GitHub
# 推送到主分支
git push -u origin main# 如果你的默认分支是 master,使用:
git push -u origin master
常见问题解决
如果遇到分支名称问题
GitHub 现在默认使用 main
分支,但有些本地 Git 版本仍使用 master
:
# 查看当前分支
git branch# 如果需要重命名分支
git branch -M main
如果远程仓库已有文件(比如初始化了 README)
# 先拉取远程内容
git pull origin main --allow-unrelated-histories# 然后再推送
git push -u origin main
如果推送时要求认证
- 使用 GitHub 个人访问令牌(Personal Access Token)代替密码
- 或者配置 SSH 密钥
完整示例流程
# 1. 进入项目目录
cd my-project# 2. 初始化 Git
git init# 3. 添加所有文件
git add .# 4. 提交
git commit -m "Initial commit"# 5. 添加远程仓库
git remote add origin https://github.com/your-username/my-project.git# 6. 推送
git push -u origin main
完成这些步骤后,你的本地工程就会成功上传到 GitHub 仓库了!