GitHub 新手入门指南：从0到1上传代码+常见问题解决

摘要

本文是专为 GitHub 新手设计的「保姆级」操作指南，覆盖从环境搭建、仓库创建到代码上传的全流程，并针对新手最常遇到的「分支找不到」「身份配置」「路径错误」等问题提供解决方案。跟着步骤操作，即使完全没接触过 Git，也能轻松将本地代码上传到 GitHub 仓库。

一、为什么需要 GitHub？

GitHub 是全球最大的代码托管平台，相当于「代码的云端仓库」。它能帮你：

• ​​备份代码​​：本地电脑故障也不怕，代码存在 GitHub 上不丢失；
• ​​协作开发​​：多人同时修改代码时，能清晰追踪每个人的修改；
• ​​开源分享​​：公开仓库可让全球开发者看到你的项目，获得反馈。

二、准备工作：安装 Git

GitHub 的核心工具是 ​​Git​​（版本控制系统），上传代码前必须先安装它。

1. 下载 Git

访问 Git 官方下载页，根据系统选择对应版本（Windows 选 .exe 安装包，Mac 推荐用 brew install git 或官网安装包）。

2. 验证安装

安装完成后，打开命令提示符（Win+R 输入 cmd 回车），输入：

git --version

如果显示版本号（如 git version 2.43.0.windows.1），说明安装成功。

三、上传代码到 GitHub：5 步搞定

步骤 1：创建 GitHub 仓库（已完成）

假设你已在 GitHub 网页端创建好仓库（如仓库名 SDtest），并记录下仓库 URL（在仓库页面点击 ​​Code​​ 按钮，复制 HTTPS 或 SSH 链接，新手推荐 HTTPS）。

步骤 2：进入本地代码文件夹

假设你的代码存放在 E:\\SDtest\\cabrontest1（或想管理整个 E:\\SDtest 目录），需先通过命令行进入目标文件夹。

​​正确操作​​（避免路径错误）：

• 若文件夹在 E 盘，先切换盘符：

  E: # 切换到 E 盘

  E: # 切换到 E 盘

• 再进入具体目录（含中文或空格时用引号包裹路径）：

  cd \"E:\\SDtest\\******test1\" # 进入子文件夹# 或（若想管理整个 SDtest 目录）cd \"E:\\SDtest\"

  步骤 3：初始化本地 Git 仓库

在目标文件夹内执行以下命令，生成 Git 隐藏目录（.git），标志着这是一个 Git 仓库：

git init

成功提示：Initialized empty Git repository in E:/SDtest/.git/（表示仓库根目录是 SDtest）。

步骤 4：关联 GitHub 远程仓库

将本地仓库与 GitHub 上的远程仓库绑定，后续推送代码时需用到仓库 URL：

git remote add origin 你的仓库URL # 示例：git remote add origin https://github.com/你的用户名/SDtest.git

• 若提示 remote origin already exists（已关联过其他仓库），需先删除旧关联：

  git remote remove origin

  再重新执行关联命令。

步骤 5：提交代码到 GitHub

5.1 添加文件到暂存区

将本地文件（或所有文件）添加到 Git 暂存区（准备提交到本地仓库）：

git add . # 添加当前目录下所有文件（含子文件夹）# 或只添加特定文件（如 main.py）：git add main.py

5.2 提交到本地仓库

将暂存区的文件提交到本地 Git 仓库，并添加描述（说明本次修改内容）：

git commit -m \"初始上传：我的第一个 GitHub 项目\"

5.3 推送到 GitHub 远程仓库

将本地仓库的内容推送到 GitHub 远程仓库（首次推送需指定分支）：

git push -u origin main # 若远程默认分支是 master，改为 git push -u origin master

四、新手常见问题与解决

问题 1：推送时提示「src refspec main does not match any」

​​原因​​：本地仓库没有 main 分支（可能默认是 master，或未提交任何内容）。
​​解决​​：

1. 查看本地分支：

   git branch # 输出类似 * master（表示当前在 master 分支）

2. 若想用 main 分支：

   git branch -m master main # 将本地 master 分支重命名为 maingit push -u origin main # 推送并关联 main 分支

问题 2：提交时提示「Author identity unknown」

​​原因​​：Git 未配置作者信息（姓名和邮箱），无法记录提交者。
​​解决​​：设置全局或当前仓库的作者信息（建议用 GitHub 关联的邮箱）：

# 全局配置（所有仓库生效）git config --global user.name \"你的名字\" # 如：张三git config --global user.email \"你的邮箱@example.com\" # 如：zhangsan@github.com# 仅当前仓库配置（覆盖全局）# 去掉 --global 参数即可：# git config user.name \"你的名字\"# git config user.email \"你的邮箱@example.com\"

问题 3：路径包含中文，Git 识别异常

​​原因​​：Windows 路径含中文可能导致 Git 无法正确读取文件。
​​解决​​：

• 将代码文件夹移动到纯英文路径（如 E:\\SDTest\\cabronTest1）；
• 或使用 Git Bash 终端（对中文路径兼容更好）。

问题 4：上传后 GitHub 页面没显示文件

​​检查步骤​​：

1. 刷新仓库页面，确认是否加载完成；
2. 检查是否执行了 git add . 和 git commit（未提交则不会上传）；
3. 若文件被 .gitignore 忽略（隐藏文件），需删除或修改 .gitignore 规则。

五、总结

通过本文的步骤，你可以轻松完成 GitHub 仓库创建、本地代码上传，并解决新手最常遇到的问题。关键是多实践，遇到错误时先通过 git status（查看当前状态）和 git branch（查看分支）定位问题，再针对性解决。

GitHub 是程序员的「代码朋友圈」，掌握它后，你可以参与开源项目、备份代码，甚至开启自己的开发者生涯！