Git 上传代码从零开始：一条命令一条命令带你推上远程仓库

别怕命令行，跟着我一步步敲，你也能把代码安全送上云端。

如果你是编程新手，或者习惯了用 GitHub 网页端那个“Upload files”按钮，那今天这篇文章就是为你准备的。我会带你在终端里，从零开始，一步一步把一个本地项目推送到远程仓库（比如 GitHub、GitLab 或 Gitee）。跟着敲一遍之后，你会发现，Git 命令其实就那么回事。

第一部分：准备工作

开始之前，请确保你已经完成了两件事：

1. 安装 Git：在终端输入git --version，如果能显示版本号（如git version 2.39.0），说明已安装。如果没有，去 Git 官网 下载安装即可。

2. 注册一个远程仓库账号：比如 GitHub、GitLab 或 Gitee（码云）。并新建一个空仓库（Repository），名字可以叫my-first-project。创建好后，你会看到一个仓库地址，类似：

   • HTTPS:https://github.com/你的用户名/my-first-project.git

   • SSH:git@github.com:你的用户名/my-first-project.git

从现在开始，请打开你的终端（Terminal）或命令行，跟我一起输入下面的每一条命令。

第二步：初始化本地仓库

首先，你需要告诉 Git：“这个文件夹，从现在开始归我管了。”

bash

# 1. 进入你的项目文件夹（用你自己的路径替换） cd /path/to/your/project # 2. 初始化 Git 仓库 git init

执行git init后，你会在项目根目录看到一个隐藏的.git文件夹。不要动它，这里面存着 Git 的所有“记忆”。

第三步：将文件添加到暂存区

现在，你需要告诉 Git 哪些文件需要被“记录”。这就像去超市买东西，先把商品放进购物车（暂存区），最后再一起结账（提交）。

bash

# 3. 查看当前状态（这是一个好习惯） git status

此时，你会看到一堆红色文件名，表示它们“未被跟踪”（Untracked）。

bash

# 4. 添加单个文件到暂存区 git add README.md # 或者，一次性添加当前目录下所有文件 git add .

执行完git add .后，再输入git status，文件会变成绿色，表示它们已经安全地躺在“购物车”里了。

第四步：提交到本地仓库——第一次“存档”

“购物车”里的内容确认无误后，就可以“结账”了。这叫做一次提交（Commit），相当于给当前的版本拍了一张快照。

bash

# 5. 提交并附上说明信息 git commit -m "项目初始化：第一次提交"

请务必写清楚-m后面的提交信息。它就像一份日记摘要，帮助你和其他人理解这次变更的目的。比如"修复了登录按钮点击无响应的问题"，就比"更新"要清晰得多。

第五步：连接到远程仓库

你的代码现在还只存在本地电脑上。接下来，需要和你在 GitHub 上创建的那个空仓库建立连接。

bash

# 6. 添加远程仓库地址（请换成你自己的地址） git remote add origin https://github.com/你的用户名/my-first-project.git

这条命令的意思是：“我给这个远程仓库起个简短的代号，叫origin”。

第六步：推送到远程仓库

这是最后一步，也是把代码真正“上传”到云端的一步。

bash

# 7. 将本地的 main 分支推送到远程的 main 分支 git push -u origin main

• push：推送。

• -u：--set-upstream的简写。它会将本地main分支与远程main分支关联起来，之后你再推送时，只需要输入git push就行了。

• origin：你刚才设置的远程仓库别名。

• main：你要推送的分支名。（早期的仓库默认分支可能是master，注意区分）

按下回车后，终端可能会弹出 GitHub 的登录窗口，要求你输入用户名和密码（或 Personal Access Token）。现在 GitHub 已经不支持用密码直接登录了，你需要使用个人访问令牌（Token）。

• 如何获取 Token？在 GitHub 设置 -> Developer settings -> Personal access tokens -> Tokens (classic) 中生成一个新的 Token，记得勾选repo权限。然后把这个 Token 粘贴到密码框里。

第七步：验证与常见问题

1. 刷新你的 GitHub 仓库页面，应该能看到文件已经成功上传了。

2. 以后每次修改代码后，只需要重复三个步骤：

   bash

   git add . git commit -m "描述你的修改" git push

💡 初次使用可能遇到的两个“拦路虎”：

• 错误failed to push some refs：这表示远程仓库有新的提交，而你没有。解决：先执行git pull --rebase origin main，把远程的更新拉到本地合并，然后再git push。

• 错误src refspec main does not match any：可能是你的本地分支不叫main，而是master。检查一下：执行git branch查看本地分支名，然后把推送命令中的main换成实际的分支名。

总结

恭喜你，你已经掌握了用 Git 命令上传代码的完整流程！回顾一下，核心操作只有这几步：

1. git init：初始化本地仓库。

2. git add .：将改动添加到暂存区。

3. git commit -m "信息"：提交到本地，形成版本记录。

4. git remote add origin <仓库地址>：连接你的远程仓库。

5. git push -u origin main：将本地代码推送到云端。

把这套流程多练习几遍，直到形成肌肉记忆。Git 是一个工具，就像骑车一样，刚开始可能生疏，一旦熟悉之后，你会发现自己再也离不开它了。