GitHub仓库创建教程：新手适用的GUI与命令行分步指南

一、GitHub网页GUI创建仓库（新手友好） #

• 登录GitHub账号，点击右上角的「+」号，选择「New repository」。
• 填写仓库核心信息：
  • Repository name：必填，不能有空格，建议用小写字母加连字符（比如my-first-python-project）
  • Description：可选，一句话说明仓库用途就行
  • Visibility：选「Public」（公开，所有人可见）或「Private」（私有，仅你和授权人能看）
• 初始化仓库（推荐勾选）：
  • 勾选「Add a README file」：这是仓库的说明书，用来介绍项目的功能、使用方法
  • 勾选「Add .gitignore」：选你用的开发语言（比如Python、JavaScript），自动生成规则忽略没必要上传的文件（比如日志、依赖包）
  • 勾选「Choose a license」：选合适的开源许可证（比如MIT），明确别人能不能用、怎么用你的代码
• 点击「Create repository」，仓库就创建好了，之后可以直接在网页上编辑文件、提交修改。

二、命令行（Git）创建并关联仓库 #

场景1：本地已有项目，推送到新的GitHub远程仓库 #

1. 先在GitHub网页上创建空仓库（不要勾选初始化README等选项），复制仓库的HTTPS或SSH地址（比如https://github.com/你的用户名/仓库名.git）。
2. 打开终端/命令提示符，进入本地项目文件夹：

   cd /path/to/your/local/project
   

3. 初始化本地Git仓库：

   git init
   

4. 把所有文件加到暂存区：

   git add .
   

5. 提交初始版本，备注写清楚：

   git commit -m "Initial commit: 项目初始化，包含基础代码结构"
   

6. 关联远程GitHub仓库：

   git remote add origin https://github.com/你的用户名/仓库名.git
   

7. 推送到远程仓库：

   git push -u origin main
   

   （如果你的本地默认分支是master，替换成master即可）

场景2：先建远程仓库，再克隆到本地开发 #

1. 在GitHub网页上创建仓库（可以勾选初始化README、.gitignore等），复制仓库地址。
2. 终端里进入要放项目的文件夹，执行克隆命令：

   git clone https://github.com/你的用户名/仓库名.git
   

3. 进入克隆好的文件夹，就可以开始写代码了，之后用git add、git commit、git push提交你的修改。

三、实用技巧与最佳实践 #

仓库创建阶段 #

• 命名要直观：用有意义的名称，别用proj1这种模糊的名字，比如react-todo-app就比my-app清楚
• README必写：哪怕是个人小项目，也要写清楚项目功能、运行步骤、依赖环境，过几个月回来也能快速上手
• .gitignore选对：根据开发语言选官方模板，别把node_modules、venv、*.log这类文件推上去，浪费仓库空间还没用
• 许可证别乱选：开源项目一定要选合适的许可证（MIT最宽松），私有项目可以不选，但如果要分享给别人，得明确授权规则

Git操作习惯 #

• 提交信息要具体：别写「fixed something」，要写「修复购物车结算时金额计算错误的问题」，方便以后追溯历史
• 用分支开发：别直接在main/master分支上改代码，建个功能分支（比如feature/add-payment），开发完再合并到主分支
• 定期拉取更新：多人协作时，每次写代码前先执行git pull，避免和别人的代码冲突
• 用SSH代替HTTPS：配置SSH密钥后，推送代码不用每次输密码，还更安全

内容的提问来源于stack exchange，提问作者Raju kushwaha