以下是一份从头到尾、覆盖安装、配置、创建仓库、上传项目到 GitHub 的完整教程。全程使用通用示例，不具备任何具体的仓库链接，仅供参考。

一、准备工作1. 注册 GitHub 账号打开浏览器，访问 GitHub官网（输入 “GitHub” 即可找到）。

点击“Sign up”或“注册”按钮，按提示输入邮箱、用户名、密码，并搞定邮箱验证。

登陆后，进入个人主页，即可进行后续操作。

二、安装并安装 Git1. 在不同操作系统上安装 GitWindows：

打开浏览器，搜索“GitWindows安装”并找到官网的下载页面。

下载最新版本的安装包（通常是以.exe结尾的资料），双击运行后一路“Next”结束安装。

安装过程中保持默认设置即可（除非你有特殊需求）。

macOS：

可以通过包管理器安装（推荐 Homebrew）。在终端中执行：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"brew install git 假如不想使用 Homebrew，也可以直接下载macOS安装包，按照提示安装。

Linux（以 Ubuntu 为例）：打开终端，执行：

sudo apt updatesudo apt install git -y 安装达成后，在任意终端（Windows 下可打开 Git Bash）里输入：

git --version 如果输出类似git version 2.x.x，说明安装成功。

2. 全局配置 Git 用户信息安装完成后，需要告诉 Git 是谁在提交代码。打开终端，依次执行：

git config --global user.name "你的用户名"git config --global user.email "你的邮箱@example.com" user.name：填写你在 GitHub 上注册的用户名或昵称。

user.email：填写与你 GitHub 帐号绑定的邮箱地址。

配置完毕后，许可用下面命令检查：

git config --global --list 会看到类似：

user.name=你的用户名user.email=你的邮箱@example.com 三、为安全验证配置 SSH（可选，但推荐）使用 SSH 方式推送/拉取代码，可以避免每次输入用户名和密码（Token）。下面介绍 SSH 公钥的生成与添加。

1. 生成 SSH 密钥对打开终端（或 Git Bash），执行：

ssh-keygen -t ed25519 -C "你的邮箱@example.com" 按提示一路回车即可，默认会在用户主目录下生成.ssh/id_ed25519（私钥）和 .ssh/id_ed25519.pub（公钥）两个文件。

如果提示 “文件已存在”，可选择覆盖或另存为其他文件名，也能够按提示输入一个新的名称。

生成完成后，执行以下命令查看公钥内容：

cat ~/.ssh/id_ed25519.pub 终端会输出一串以ssh-ed25519开头的字符串，这就是公钥。

2. 将 SSH 公钥添加到 GitHub在浏览器中，登陆 GitHub，点击右上角头像，选择“Settings”（设置）。

在左侧栏中找到SSH and GPG keys，点击进入。

点击 New SSH key（新增 SSH 密钥），在“Title”框里可以填写一个有意义的名字（例如 “My Laptop”），然后把刚才复制的公钥粘贴到下面的文本框中，最后点击Add SSH key。

如果 GitHub 要求你输入账号密码或两步验证码，按提示输入即可。

添加成功后，SSH 验证就设置完毕。行测试连接：

ssh -T git@github.com 要是提示类似 “Hi <用户名>! You've successfully authenticated...” 则说明 SSH 验证配置正确。

四、在 GitHub 上创建一个空仓库登陆 GitHub 后，点击右上角的 “+” 按钮，选择New repository（新建仓库）。

在 “Create a new repository” 页面填写：

Repository name：为你的项目起个名字，例如my-project。

Description（可选）：添加简短描述。

Public 或 Private：根据应该选择公开或私有。

Initialize this repository with a README：通常不勾选，否则会自动生成一个README文件，后续需要先拉取再推送。

点击下方的 Create repository（创建仓库），稍等片刻后就会进入新仓库页面。页面上会给出 HTTPS 和 SSH 两种地址，如：

HTTPS:https://github.com/你的用户名/my-project.git

SSH: git@github.com:你的用户名/my-project.git记住这两个地址中的一种，后续用来关联本地仓库。

五、将本地工程与远程仓库关联并上传下面以一个已存在本地计划的目录为例，演示如何上传到 GitHub。假设本地任务文件夹路径为~/projects/my-project，且目录下已有若干源代码或资源文件。

1. 在本地初始化 Git 仓库打开终端，切换到项目根目录：

cd ~/projects/my-project 在该目录下执行：

git init 这会创建一个隐藏的.git/文件夹，使该目录成为一个 Git 仓库。

你可以运行 ls -A 或 git status来确认目录下已有普通文件，但 Git 还没追踪它们。

2. 将档案添加到暂存区并提交查看当前状态（可选）：

git status 这时 Git 会告诉你哪些文件是 “Untracked files”（未跟踪文件）。

把所有文件添加到暂存区：

git add . 这样做会把当前目录（及子目录）下所有未被忽略的记录都纳入暂存区。

创建第一次提交：

git commit -m "首次提交：计划初始化" 以上操作会在本地生成一个提交记录（commit），大多数情况下会默认在master分支上。如果想直接把主分支命名为main，可以执行：

git branch -M main 这样以后本地仓库的主分支就是main（与 GitHub 通用约定保持一致）。

3. 将本地仓库与远程仓库关联在本地执行下面命令，将远程仓库地址添加为名为origin 的远程源：

使用 HTTPS（得每次输入用户名/密码或 Token）：

git remote add origin https://github.com/你的用户名/my-project.git 使用 SSH（已配置 SSH 密钥则无需输入密码）：

git remote add origin git@github.com:你的用户名/my-project.git 注意：命令开头务必是小写的git，不要带任何隐藏字符或破折号。

添加成功后，可用下面命令确认：

git remote -v 你会看到类似：

origin https://github.com/你的用户名/my-project.git (fetch)origin https://github.com/你的用户名/my-project.git (push) 或者如果用的是 SSH，则显示：

origin git@github.com:你的用户名/my-project.git (fetch)origin git@github.com:你的用户名/my-project.git (push) 4. 推送本地提交到远程仓库假设当前分支是main：

git push -u origin main 如果当前分支是master（没有重命名为main），则：

git push -u origin master -u origin main：把本地就是的含义main分支推送到远程origin，并建立跟踪关系。以后只需直接执行git push 即可。

在推送过程中，如果使用 HTTPS，需要输入 GitHub 用户名和密码（如果启用了两步验证，则输入 Personal Access Token）；倘若使用 SSH，且 SSH key 已配置好，则不会再提示输入密码。

推送成功后，终端会显示类似：

Enumerating objects: 10, done.Counting objects: 100% (10/10), done.Compressing objects: 100% (7/7), done.Writing objects: 100% (10/10), 1.23 KiB | 1.23 MiB/s, done.Total 10 (delta 0), reused 0 (delta 0)To https://github.com/你的用户名/my-project.git * [new branch] main -> mainbranch 'main' set up to track 'origin/main'. 刷新浏览器，打开 GitHub 上该仓库页面，就能看到你刚才上传的所有档案。

六、后续开发与同步项目上传成功后，后续只需按照下面步骤更新远程仓库即可。

1. 修改/新增材料后上传在本地对档案进行修改或新增文件。

查看计划状态：

git status 可能看到哪些文件被修改、哪些是新文件。

添加改动到暂存区：

如要一次添加所有改动：

git add . 如果只想添加某个文件：

git add path/to/yourfile.ext 提交改动：

git commit -m "本次更新：简要说明修改内容" 推送到远程：

git push 由于第一次已经用-u origin main 或 -u origin master与远程分支建立了跟踪关系，后续直接git push 即可。

2. 如果远程仓库有了新的提交（多人协作时常见）在推送之前，可以先拉取远程更新：

git pull --rebase origin main 或者：

git pull origin main 带 --rebase可以保持提交历史线性；不带则会自动创建一个合并提交（Merge commit）。

如果出现冲突（Conflict），按提示打开冲突文件，手动保留、删除冲突标记（<<<<<<<、=======、>>>>>>>），然后执行：

git add 冲突已解决的文件git rebase --continue # 如果使用了 --rebase 或者如果是普通git pull：

git add 冲突已处理的文件git commit 冲突解决完成后再执行git push，即可把本地改动与远程最新内容同步。

七、常见问题与注意事项命令前不要出现隐藏字符

如果复制粘贴时前面多了不可见破折号（如 “–”）或空格，Git 会识别为非法命令，从而提示 “command not found”。遇到这种情况，请按几次退格键把前导的隐藏字符清除，然后再手动输入git init、git add 等命令。

.gitignore 文件

在工程根目录创建一个名为.gitignore的文件，写入你不想跟踪（即不想上传到远程）的文件或文件夹规则。常见示例：

node_modules/*.log.env.DS_Storebuild/*.pyc 这样做可以避免把编译生成的临时文件、IDE 配置、依赖包等无关文件上传到仓库。

分支管理

默认情况下，你会在main（或 master）分支上工作。要是想开发新功能、修复 Bug，通常会新建分支：

git checkout -b feature/新功能名称 完成开发并测试通过后，切回main分支并合并：

git checkout maingit merge feature/新能力名称git branch -d feature/新功能名称 合并完成后，再执行git push即可把合并后的结果推到远程。

SSH 与 HTTPS

倘若长时间需要频繁推送，推荐使用 SSH 方式，只需在本地生成过一次 SSH 密钥，并把公钥添加到 GitHub，就不需要每次输入用户名/密码或 Token。

如果安全要求较高或不方便配置 SSH，也可以继续使用 HTTPS，但每次推送时都可能需要输入 Token。

Token 和安全

GitHub 已逐步弃用直接使用密码进行 HTTPS 验证，强制使用个人访问令牌（Personal Access Token）。

在终端推送时，如果提示要求用户名和密码，你可以把用户名填为 GitHub 用户名，然后把个人访问令牌粘贴到密码处。访问令牌允许在 GitHub 个人设置里新建。

远程仓库已初始化 README 情况

如果你在新建仓库时勾选了“初始化 README”，远程仓库就会自带一个提交记录。这时本地一开始是空的，假如你直接执行git push会被拒绝（提示需先拉取远程更改）。解决方法是先执行：

git pull --rebase origin main 把远程的那次提交拉下来并合并到本地，然后再git push。

八、小结安装 Git 并配置 user.name、user.email。

（可选）配置 SSH 密钥，将公钥添加到 GitHub。

在 GitHub 上创建一个空仓库（不勾选初始化 README）。

在本地项目目录执行git init，将计划转为 Git 仓库。

执行 git add .、git commit -m "描述"，完毕首次提交。

使用 git remote add origin <远程仓库地址> 关联远程。

执行 git push -u origin main（或 master）将本地提交推送到 GitHub。

后续开发：用 git add → git commit → git push完毕更新。若需合并远程改动，先git pull --rebase 再 git push。

以上步骤涵盖了从安装软件到首次上传，再到后续代码同步的完整流程。只要每一步都按照说明并自己手动输入命令，就能顺利把项目上传并保持与 GitHub 的同步。