GitHub仓库搭建需五步:一、注册账户并邮箱验证;二、安装Git并配置用户名与邮箱;三、创建远程仓库并复制HTTPS/SSH地址;四、本地初始化仓库并关联远程地址;五、添加文件、提交并推送至main分支。

如果您是 GitHub 新手,希望从零开始创建并管理自己的代码仓库,则需要完成账户注册、本地环境配置、仓库初始化及远程同步等基础操作。以下是完成 GitHub 仓库搭建的完整步骤:
一、注册 GitHub 账户并完成邮箱验证
GitHub 仓库托管依赖于有效的用户账户,注册后必须通过邮箱验证才能启用全部功能,包括创建私有仓库和推送代码。
1、访问 https://github.com/join,填写用户名、邮箱和密码。
2、提交注册表单后,登录注册邮箱,查找来自 GitHub 的验证邮件。
3、点击邮件中的 Verify email address 链接完成验证。
二、安装 Git 并配置用户信息
Git 是 GitHub 本地交互的核心工具,必须在计算机上安装并设置全局用户名与邮箱,否则后续提交将因身份缺失而被拒绝。
1、前往 https://git-scm.com/downloads 下载对应操作系统的 Git 安装包并完成安装。
2、打开终端(Windows 使用 Git Bash,macOS/Linux 使用 Terminal),执行以下命令:
3、输入 git config --global user.name "YourGitHubUsername",将 YourGitHubUsername 替换为您的实际 GitHub 用户名。
4、输入 git config --global user.email "your_email@example.com",邮箱需与 GitHub 账户注册邮箱一致。
三、创建远程仓库并获取 HTTPS 或 SSH 地址
远程仓库是代码托管的中心节点,创建时需明确仓库名称、可见性(公开/私有)及是否初始化 README,地址类型决定后续推送方式的安全性与认证机制。
1、登录 GitHub 网站,点击右上角 + → New repository。
2、在 Repository name 栏输入仓库名(如 my-first-project),不填路径,保持默认命名空间。
3、选择 Public 或 Private,勾选 Add a README file 可自动生成初始文件。
4、点击 Create repository,进入仓库主页后,点击绿色按钮 Code,复制显示的 HTTPS 地址或切换至 SSH 标签页复制 SSH 地址。
四、初始化本地仓库并关联远程地址
本地仓库是代码编辑与版本控制的操作起点,通过 git init 建立 Git 管理目录,并使用 git remote add 将其绑定到 GitHub 远程仓库,建立双向通信通道。
1、在电脑中新建文件夹(如 ~/my-first-project),打开终端并执行 cd ~/my-first-project 进入该目录。
2、运行 git init 初始化空 Git 仓库。
3、执行 git remote add origin https://github.com/YourGitHubUsername/my-first-project.git,将远程地址替换为第三步中复制的实际地址。
4、若使用 SSH 方式,命令应为 git remote add origin git@github.com:YourGitHubUsername/my-first-project.git。
五、提交首个代码并推送到 GitHub
首次推送需完成文件添加、提交记录生成及分支同步三个动作,其中 main 是 GitHub 默认主分支名,推送时必须显式指定分支以避免错误。
1、在本地文件夹中新建一个文本文件(如 README.md),写入任意内容并保存。
2、执行 git add README.md 将文件加入暂存区;也可用 git add . 添加所有变更文件。
3、运行 git commit -m "Initial commit" 创建带有描述的提交快照。
4、输入 git branch -M main 确保本地主分支名为 main(旧版 Git 可能默认为 master)。
5、执行 git push -u origin main 将本地 main 分支首次推送到远程 origin,并设置上游跟踪。










