使用git上传项目的步骤

使用 Git 上传项目（即把本地项目代码推送到远程仓库，比如 GitHub、GitLab、Gitee 等）是一个非常常见的操作。下面是 ​详细的、一步一步的 Git 上传项目流程，适用于大多数情况，以 ​GitHub 为例，但同样适用于其他平台（如 Gitee、GitLab）。

🧭 一、整体流程概览

1. ​检查/安装 Git​
2. ​初始化本地 Git 仓库​
3. ​将项目文件添加到暂存区​
4. ​提交更改到本地仓库​
5. ​连接到远程仓库（如 GitHub）​​
6. ​推送代码到远程仓库​

✅ 二、详细步骤

第 1 步：检查是否安装了 Git

在终端（Windows：CMD/PowerShell/Git Bash；Mac/Linux：Terminal）中输入： 

git --version

如果显示类似 git version 2.xx.x，说明已安装。
如果没有安装，请先下载并安装 Git：

• 官网下载：https://git-scm.com/

第 2 步：打开你的项目文件夹

通过终端，​进入到你的项目根目录，也就是包含 .vue / .js / package.json 等文件的地方。 

cd /path/to/your/project

比如： 

cd ~/Desktop/my-react-app

你可以使用 pwd（Mac/Linux）或 cd（Windows）查看当前路径，确保你在正确的项目文件夹中。

第 3 步：初始化 Git 仓库

在项目根目录下运行： 

git init

这会在当前目录下创建一个隐藏的 .git 文件夹，表示此文件夹已被 Git 管理。

第 4 步：将项目文件添加到 Git 暂存区

运行以下命令，将所有文件添加到暂存区（stage）： 

git add .

⚠️ 注意：

• git add . 表示添加当前目录下所有新文件和修改的文件。
• 如果只想添加某个文件，可以用：git add 文件名
• 如果想更精准控制，可以先 git status 查看哪些文件未被跟踪

第 5 步：提交文件到本地仓库

将暂存区的文件提交到本地 Git 仓库，并添加提交说明： 

git commit -m "feat: 初始化项目 / 第一次提交"

💡 提交信息推荐写得清晰些，比如：

• "feat: 初始化项目结构"
• "fix: 修复登录页面样式"
• "docs: 更新 README"

第 6 步：在远程代码托管平台（如 GitHub）创建仓库

1. 打开 https://github.com 并登录。
2. 点击右上角 ​​"+" → New repository。
3. 输入仓库名称（如 my-react-app），​不要勾选 "Initialize with README"​​（除非你明确需要）。
4. 选择 Public 或 Private。
5. 点击 ​Create repository。

创建成功后，GitHub 会显示一个类似于下面的页面，里面有你的 ​远程仓库地址（HTTPS 或 SSH）​，类似：

• HTTPS 地址：
  https://github.com/你的用户名/仓库名.git

• SSH 地址：
  git@github.com:你的用户名/仓库名.git

🔗 你可以从页面上复制这个远程仓库地址，待会要用。

第 7 步：将本地仓库与远程仓库关联

在本地终端运行以下命令，将本地 Git 仓库与远程仓库关联： 

git remote add origin 远程仓库地址

比如： 

git remote add origin https://github.com/yourusername/your-repo-name.git

或者使用 SSH（如果你配置了 SSH key）：

git remote add origin git@github.com:yourusername/your-repo-name.git

🔒 ​HTTPS vs SSH：​​

• ​HTTPS​：每次推送可能需要输入账号密码（或使用 token）。
• ​SSH​：更安全、便捷，但需要你提前配置 SSH key。

第 8 步：首次推送代码到远程仓库

如果是 ​第一次推送，你需要使用以下命令： 

git push -u origin main

⚠️ 注意：

• 很多新仓库的默认分支名字已经从 master 改成了 main（GitHub、GitLab 等）。
• 如果你看到错误说没有 main 分支，可能你本地分支叫 master，可以改成：

  git push -u origin master

​解释：​​

• -u（或 --set-upstream）的意思是设置默认推送的分支，以后你可以直接使用 git push 而不用每次都写 origin main。

第 9 步：验证是否推送成功

1. 刷新你在 GitHub 上刚创建的仓库页面。
2. 你应该能看到你刚刚推送的文件，比如 package.json、src/、README.md 等。
3. 如果看到这些文件，说明你成功上传了项目！

🔄 三、之后再次推送更新（日常使用）

当你对项目做了新的修改，并想提交并推送到远程仓库时，重复以下步骤即可： 

# 1. 查看当前修改状态（可选）
git status

# 2. 添加修改的文件到暂存区
git add .

# 或者只添加特定文件
# git add src/App.js

# 3. 提交到本地仓库
git commit -m "描述你的修改，如：fix: 修复按钮样式"

# 4. 推送到远程仓库
git push

如果你已经设置过 upstream（比如用了 -u），后面的 git push 可以不用加 origin main。

🧠 四、常用 Git 命令速查表

❗ 常见问题

1. ​git push 提示权限不足？​​

• 如果你用的是 HTTPS，可能需要输入 GitHub 用户名和 ​Personal Access Token（不是密码）​。
• 推荐使用 SSH 方式，只需配置一次 SSH key 即可免密推送。

2. ​git push 提示 fatal: not a git repository？​​

• 说明你没有在这个目录下运行 git init，请确认你当前在项目文件夹内。

3. ​如何切换分支？​​

• 查看分支：git branch
• 切换分支：git checkout 分支名
• 创建并切换分支：git checkout -b 新分支名

✅ 总结：用 Git 上传项目的完整流程