Git的基本使用

准备工作:安装Git与配置信息

使用前请去Git官网 https://git-scm.com/安装Git。

  1. 安装完成后。配置用户信息
git config --global user.name "你的GitHub用户名"
git config --global user.email "你的GitHub邮箱"

第一步:在 GitHub 上创建一个远程仓库

  1. 登录你的 GitHub 账号。
  2. 点击页面右上角的 + 号,选择 New repository。
  1. 填写仓库信息:
    • Repository name:给你的项目起个名字。
    • Description:可选的简短描述。
    • Public / Private:选择仓库是公开还是私有。
  2. 重要:不要勾选 “Add a README”、“Add .gitignore” 等初始化选项,保持仓库为空。
  3. 点击绿色的 Create repository 按钮。
  4. 创建成功后,复制新仓库的 HTTPS 或 SSH 地址,后面会用到。

第二步:初始化Git添加文件到本地仓库

​ 建议:在执行此步前,先创建一个 .gitignore 文件,在其中指定 Git 需要忽略的文件(如日志、缓存、本地配置等),避免将无用或敏感文件上传。

# 进入项目文件夹
cd ‘你的项目文件夹路径’
# 初始化Git仓库,会在项目目录下创建一个名为 .git 的隐藏文件夹,用来管理版本
git init
# 将项目所有文件添加到 Git 的“暂存区”
git add .
# 将暂存区的文件提交到本地仓库,并附上一段说明信息,-m后面为本次提交的说明
git commit -m "第一次的提交"

第三步:关联远程GitHub仓库并推送

# 关联远程仓库
git remote add origin https://github.com/你的用户名/你的仓库名.git
# 推送本地代码到GitHub
git branch -M main
git push -u origin main
# 拉取远端仓库最新文件操作为:git pull
  • git branch -M main:将本地默认分支名重命名为 main,与 GitHub 保持一致。
  • git push -u origin main:将代码推送到远程仓库的 main 分支。-u 参数会建立本地与远程分支的关联,之后再次推送时,只需输入 git push 即可

补充:若是启动了VPN(代理)

​ 如果你电脑开启了VPN代理软件,Git 默认不会走系统代理,需要手动告诉 Git 使用它。

# 先查看你的代理软件本地监听端口(通常是 7890、1080 或 10809,以 代理🐱 为例默认7890)
git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890

​ 配置好后,重新执行推送命令

git push -u origin main

注意:推送成功后,若想恢复直连,可执行 git config --global --unset http.proxy 和 --unset https.proxy

后记:推送失败的常见原因

​ 在创建仓库时很可能勾选了 “Add a README file” 或生成了 .gitignore / License,而你的本地项目是全新初始化的,两者的提交历史毫无关联,所以 Git 拒绝了推送。

  • 方法一(安全合并)
# 这个方法会把 GitHub 上的 README 等文件下载到本地,与你的项目合并后再一起推送
git pull origin main --allow-unrelated-histories
# 再次推送
git push origin main
  • 方法二(强制推送)
# 确定GitHub上的README等初始化文件没用,直接用本地全部内容覆盖掉远程仓库,可以强制推送。
git push -f origin main

​ 注意:-f 代表 --force,会直接覆盖远程仓库的所有内容,使其变得和本地完全一样。请确保远程仓库没有别人提交的重要代码,否则会丢失。


高频使用场景组合:

  • 日常提交三部曲:
    git status → git add . → git commit -m "update" → git push
  • 拉取最新代码:
    git pull origin main(或者先 git fetch 再 git merge)
  • 切换分支:
    git checkout feature-branch 或 git switch feature-branch
posted @ 2026-09-06 22:52  CloudWK  阅读(43)  评论(0)    收藏  举报