目录

一、准备工作

二、下载GitHub项目

方法1：使用 git clone

方法2：下载ZIP文件

三、上传项目到GitHub

步骤1：在GitHub创建新仓库

步骤2：初始化本地仓库

步骤3：提交并推送代码

四、后续更新项目

常见问题

---

一、准备工作

1. 安装 Git：

   • 如果尚未安装 Git，请从 Git 官网 下载并安装。

   • 安装完成后，打开终端（或命令行）并配置用户名和邮箱：

     git config --global user.name "Your Name"
     git config --global user.email "your.email@example.com"

2. 创建 GitHub 账号：

   • 如果还没有 GitHub 账号，请先注册一个。

3. 创建 GitHub 仓库：

   • 登录 GitHub，点击右上角的 + 按钮，选择 New repository。

   • 填写仓库名称，选择公开或私有，然后点击 Create repository。

---

  

二、下载GitHub项目

方法1：使用 git clone

1. 获取仓库URL：

   • 打开GitHub项目页面，点击绿色“Code”按钮。

   • 选择HTTPS或SSH协议，复制URL（如：https://github.com/用户名/仓库名.git）。

2. 克隆到本地（命令行）：

        在一个目录下右键打开git命令行，然后复制：

git clone 复制的URL

//示例：
git clone https://github.com/octocat/Hello-World.git

方法2：下载ZIP文件

• 在GitHub仓库页面点击“Download ZIP”，解压即可（无需Git）。

---

  

三、上传项目到GitHub

步骤1：在GitHub创建新仓库

1. 登录GitHub，点击右上角“+” → “New repository”。

2. 填写仓库名，选择公开/私有，不要初始化README（避免冲突）。

步骤2：初始化本地仓库

1. 进入项目文件夹，初始化Git：

   git init

2. 关联远程仓库：

   git remote add origin 仓库URL

   //示例：
   git remote add origin https://github.com/你的用户名/仓库名.git

3. 验证远程仓库是否添加成功：

   git remote -v

   应该会显示类似以下内容：

   origin  https://github.com/username/MyQtProject.git (fetch)
   origin  https://github.com/username/MyQtProject.git (push)

步骤3：提交并推送代码

1. 添加文件到暂存区：

   git add .  # 添加所有文件，或指定文件：git add 文件名

2. 提交更改：

   git commit -m "提交描述"

3. 推送到GitHub：

   git push -u origin main  # 首次推送需加`-u`

   如默认分支为master，替换main为master。

---

  

四、后续更新项目

1. 修改文件后，重复提交步骤：

   git add .
   git commit -m "更新描述"
   git push  # 后续无需`-u`

2. 拉取远程更新（他人修改后）：

   git pull

---

  

常见问题

• 权限错误：检查URL协议（HTTPS需密码，SSH需密钥）。

• 分支冲突：先执行git pull合并远程更改再推送。

• 忽略文件：创建.gitignore文件，列出需排除的文件/目录。