如何上传代码到 GitHub

最新推荐文章于 2025-06-03 10:17:00 发布

原创最新推荐文章于 2025-06-03 10:17:00 发布 · 1.1k 阅读

10 ·

CC 4.0 BY-SA版权

文章标签：

#github

1. 前言：为什么要使用 GitHub？

GitHub 是全球最大的代码托管平台，开发者可以用它：

备份代码（防止本地丢失）
团队协作（多人共同开发）
开源分享（让全世界看到你的项目）
版本控制（随时回退到历史版本）

本文将详细介绍如何从零开始上传代码到 GitHub，适合 Git 新手。

2. 准备工作

2.1 注册 GitHub 账号

访问 GitHub 官网注册账号（建议使用英文用户名）。

2.2 安装 Git

Windows：下载 Git for Windows
Mac：终端运行 brew install git
Linux（Ubuntu/Debian）：sudo apt install git

安装后验证是否成功：

git --version
# 应输出类似：git version 2.37.1

2.3 配置 Git 用户名和邮箱

git config --global user.name "你的GitHub用户名"
git config --global user.email "你的GitHub注册邮箱"

3. 上传代码到 GitHub 的两种方式

方式 1：从本地新项目上传

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

cd 你的项目文件夹
git init

步骤 2：添加文件到暂存区

git add .  # 添加所有文件
# 或指定文件：git add README.md

步骤 3：提交更改

git commit -m "首次提交：项目初始化"

步骤 4：在 GitHub 创建新仓库

登录 GitHub，点击右上角 + → New repository
填写仓库名（如 my-project），选择 Public/Private
不要勾选 “Initialize this repository with a README”（因为本地已有代码）

步骤 5：关联远程仓库并推送

git remote add origin https://github.com/你的用户名/仓库名.git
git branch -M main  # 默认分支改名为main（GitHub新仓库要求）
git push -u origin main

输入 GitHub 账号密码（或 Personal Access Token）。

方式 2：从已有 GitHub 仓库克隆

如果 GitHub 上已有仓库（如从别人的项目 fork）：

git clone https://github.com/用户名/仓库名.git
cd 仓库名
# 修改代码后...
git add .
git commit -m "你的修改描述"
git push

4. 常见问题解决

4.1 认证失败（不再支持密码登录）

GitHub 已禁用密码登录，需用 Personal Access Token (PAT)：

生成 Token：
- GitHub → Settings → Developer settings → Personal Access Tokens → Generate new token
- 勾选 repo 权限

推送时用 Token 替代密码：

git push https://<你的TOKEN>@github.com/用户名/仓库名.git

4.2 冲突处理

如果远程仓库有更新，需先拉取：

git pull origin main
# 解决冲突后再提交
git push

4.3 忽略文件（.gitignore）

创建 .gitignore 文件，列出不想上传的文件（如临时文件、编译产物）：

# 示例：忽略Unity临时文件
/[Ll]ibrary/
/[Tt]emp/
*.log

5. 图形化工具推荐（适合新手）

如果觉得命令行复杂，可以使用：

GitHub Desktop（官方工具，简单易用）
VS Code 内置 Git 功能（按 Ctrl+Shift+G 打开）
Sourcetree（功能更强大）

6. 最佳实践

频繁提交：小步提交，避免一次性推送大量改动
写好 Commit Message：
- 错误示例：git commit -m "fix bug"
- 正确示例：git commit -m "修复玩家移动时卡墙的问题"

分支管理：

git checkout -b new-feature  # 创建新分支
git push origin new-feature  # 推送分支

7. 总结

上传代码到 GitHub 只需 4 步：

git init → 初始化仓库
git add . → 添加文件
git commit -m "消息" → 提交更改
git push → 推送到 GitHub

掌握 Git 是开发者必备技能，现在就去 GitHub 创建你的第一个仓库吧！

延伸阅读：