GitHub初体验

# GitHub 初次初始化仓库及通过 CMD 上传指南 ## 一、创建 GitHub 仓库 ### 1. 登录 GitHub 账号 访问 [GitHub 官网](https://github.com)，使用账号登录。 ### 2. 创建新仓库 - 点击右上角的"+"号，选择"New repository" - 输入仓库名称（Repository name），例如 `my-first-repo` - 可选：添加描述（Description），例如"我的第一个GitHub仓库" - 选择仓库可见性： - **Public**：公开，任何人都可以查看 - **Private**：私有，只有授权用户可以查看 - 勾选"Initialize this repository with a README"（推荐） - 点击"Create repository"完成创建 ## 二、本地环境准备 ### 1. 安装 Git - 访问 [Git 官网](https://git-scm.com) 下载安装包 - 按照默认选项完成安装 - 验证安装：打开 CMD，输入 `git --version` ### 2. 配置 Git 用户信息 ```bash # 配置用户名（与 GitHub 用户名一致） git config --global user.name "你的GitHub用户名" # 配置邮箱（与 GitHub 邮箱一致） git config --global user.email "你的GitHub邮箱" # 可选：设置默认分支为 main（Git 2.28+） git config --global init.defaultBranch main ``` ### 3. 创建本地项目 ```bash # 创建项目文件夹 mkdir D:\my-first-repo # 进入项目文件夹 cd D:\my-first-repo # 初始化 Git 仓库 git init ``` ## 三、关联远程仓库 ### 1. 获取远程仓库地址 - 在 GitHub 仓库页面，点击"Code"按钮 - 选择"HTTPS"（推荐给初学者） - 复制仓库地址，格式为：`https://github.com/用户名/仓库名.git` ### 2. 添加远程仓库 ```bash # 关联远程仓库 git remote add origin https://github.com/你的用户名/my-first-repo.git # 验证关联 git remote -v ``` ## 四、分支名称差异说明 ### 问题背景 - **Windows Git 默认**：创建 `master` 分支 - **GitHub 默认**：创建 `main` 分支 - **历史原因**：Git 早期使用 `master`，GitHub 于 2020 年改为 `main` ### 解决方案（三选一） #### 方案一：直接推送（最简单） ```bash # 如果远程是 main 分支 git push -u origin master:main # 或直接推送 git push -u origin master ``` #### 方案二：重命名本地分支（推荐） ```bash # 重命名本地分支 git branch -M main # 推送重命名后的分支 git push -u origin main ``` #### 方案三：创建新分支 ```bash # 创建并切换到 main 分支 git checkout -b main # 推送新分支 git push -u origin main # 可选：删除旧的 master 分支 git branch -d master ``` ## 五、上传文件到 GitHub ### 1. 添加文件到暂存区 ```bash # 添加所有文件 git add . # 或添加特定文件 git add index.html README.md ``` ### 2. 提交到本地仓库 ```bash # 提交并添加描述 git commit -m "Initial commit: 添加初始文件" # 查看提交历史 git log --oneline ``` ### 3. 推送到远程仓库 ```bash # 首次推送（使用 -u 参数设置上游分支） git push -u origin main # 后续推送（简化） git push ``` ## 六、验证上传结果 ### 1. 检查 GitHub 仓库 - 刷新 GitHub 仓库页面 - 确认文件已显示 - 查看提交历史 ### 2. 本地验证 ```bash # 查看远程仓库状态 git remote show origin # 查看所有分支 git branch -a # 拉取最新更改 git pull origin main ``` ## 七、常见问题解决 ### 问题 1：推送失败（分支不匹配） ```bash # 查看远程分支 git ls-remote --heads origin # 拉取远程分支并合并 git pull origin main --allow-unrelated-histories # 重新推送 git push -u origin main ``` ### 问题 2：认证失败 ```bash # 使用 SSH 密钥（推荐） # 1. 生成 SSH 密钥 ssh-keygen -t rsa -b 4096 -C "你的邮箱" # 2. 将公钥添加到 GitHub # 3. 修改远程地址为 SSH git remote set-url origin git@github.com:用户名/仓库名.git ``` ### 问题 3：文件冲突 ```bash # 先拉取最新代码 git pull origin main # 解决冲突后重新提交 git add . git commit -m "解决冲突" git push ``` ## 八、最佳实践建议 ### 1. 提交规范 - 使用有意义的提交信息 - 遵循约定式提交（Conventional Commits） - 示例：`feat: 添加用户登录功能` ### 2. 分支管理 ```bash # 创建功能分支 git checkout -b feature/new-feature # 合并到主分支 git checkout main git merge feature/new-feature # 删除已合并的分支 git branch -d feature/new-feature ``` ### 3. .gitignore 文件 创建 `.gitignore` 文件，排除不需要版本控制的文件： ``` # 依赖目录 node_modules/ vendor/ # 环境文件 .env .env.local # 系统文件 .DS_Store Thumbs.db # 日志文件 *.log ``` ## 九、常用命令速查 | 命令 | 说明 | |------|------| | `git init` | 初始化仓库 | | `git clone ` | 克隆远程仓库 | | `git status` | 查看状态 | | `git add ` | 添加文件 | | `git commit -m "msg"` | 提交更改 | | `git push` | 推送到远程 | | `git pull` | 拉取更新 | | `git branch` | 查看分支 | | `git checkout ` | 切换分支 | | `git merge ` | 合并分支 | | `git log` | 查看历史 | ## 十、后续学习建议 1. **学习 Git 分支策略**：Git Flow、GitHub Flow 2. **了解 Pull Request**：代码审查流程 3. **学习 GitHub Actions**：自动化工作流 4. **探索 GitHub Pages**：静态网站托管 5. **参与开源项目**：Fork 和贡献代码 --- **提示**：初次使用可能会遇到各种问题，这是正常的学习过程。多练习、多搜索、多尝试，Git 和 GitHub 会成为你开发工作中的得力助手。 **相关资源**： - [Git 官方文档](https://git-scm.com/doc) - [GitHub 学习实验室](https://github.com/apps/github-learning-lab) - [Pro Git 中文版](https://git-scm.com/book/zh/v2)