GitHub与Git的使用

GitHub 是基于 Git 的代码托管平台，用于展示项目、协作开发，而 Git 是分布式版本控制系统，用于本地代码管理。以下是 GitHub 与 Git 的使用指南：

• 安装：从
  Git 官网
  下载对应操作系统的安装包，按向导完成安装。
• 配置：

  打开 Git Bash，设置全局用户名和邮箱（用于标识提交者）：

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

  配置 SSH 密钥（用于 GitHub 免密登录）：

  生成密钥：ssh-keygen -t rsa -C "your.email@example.com"，按提示操作，默认路径为 ~/.ssh/id_rsa.pub。

  将公钥内容（id_rsa.pub 文件）添加到 GitHub 的 Settings → SSH and GPG keys 中。

1. 初始化本地仓库：

   在项目目录下打开 Git Bash，执行：

   git init

   创建文件（如 README.md），添加到暂存区并提交：

   git add .git commit -m "Initial commit"

2. 关联远程仓库：

   在 GitHub 新建仓库（New repository），获取 SSH 地址（如 git@github.com:username/repo.git）。

   在本地仓库执行：

   git remote add origin git@github.com:username/repo.git

   推送代码到远程仓库（首次需指定分支）：

   git push -u origin main # GitHub 默认分支可能为 main 而非 master

• 常用命令：

  git status：查看当前状态（未跟踪、已修改等）。

  git log：查看提交历史。

  git branch：管理分支（创建、切换、合并等）。

  git checkout -b feature：创建并切换到 feature 分支。

  git merge feature：将 feature 分支合并到当前分支。

• 仓库链接获取：在 GitHub 仓库页面点击 Code → SSH，复制地址即可，无需手动编写。

1. error: src refspec master does not match any：

   原因：本地无 master 分支（GitHub 默认分支可能为 main），或未提交任何内容。

   解决：

   确认分支名是否正确（如 main）：

   git push -u origin main

   确保至少有一次提交（git commit）。

1. 提交超过 100MB 文件失败：

   原因：GitHub 对单个文件大小限制为 100MB。

   解决：

   使用 Git LFS（Large File Storage）管理大文件：

   git lfs installgit lfs track "*.psd" # 指定大文件类型

   或压缩文件后分块上传，或使用其他存储服务（如云盘）链接引用。

1. .git/objects 占用空间过大：

   原因：频繁提交大文件或未清理历史。

   解决：

   删除 .git 文件夹后重新初始化（会丢失历史记录）：

   rm -rf .gitgit init

   或使用 git gc 清理无用对象（效果有限）。

2. 删除仓库中的文件夹：

   方法：

   本地删除文件夹后提交：

   rm -rf folder_namegit add -ugit commit -m "Delete folder"git push origin main

   或通过 GitHub 网页端直接删除（进入仓库 → 选择文件夹 → Delete）。

1. 克隆仓库到本地：

   git clone git@github.com:username/repo.gitcd repo # 进入仓库目录

2. 拉取最新更新：

   拉取 main 分支内容：

   git pull origin main

   若需合并无关历史（如初始化时），添加 --allow-unrelated-histories：

   git pull origin master --allow-unrelated-histories

3. 删除本地缓存文件（如误提交敏感文件）：

   git rm -r --cached trash # 删除 trash 文件夹的缓存git commit -m "Remove trash from cache"git push origin main

• 修改远程仓库地址：

  git remote set-url origin new_ssh_address

  或先删除再添加：

  git remote rm origingit remote add origin new_ssh_address

• 忽略文件：创建 .gitignore 文件，写入需忽略的文件名或通配符（如 *.log）。

通过以上步骤，可高效使用 Git 管理本地代码，并通过 GitHub 实现协作与展示。