从零开始 - 在GitHub创建项目并上传代码

一、 引言为什么使用GitHub版本控制的重要性追溯代码变更团队协作基石防止代码丢失GitHub的定位全球最大的代码托管平台社交化编程开源项目的温床本文目标引导你完成首次GitHub项目创建与上传二、 准备工作注册GitHub账号访问官网 (https://github.com/)填写用户名、邮箱、密码验证邮箱本地环境准备安装 Git# Linux (Debian/Ubuntu) sudo apt-get install git # macOS (建议使用Homebrew) brew install git # Windows 下载安装包验证安装git --version配置全局用户信息重要git config --global user.name 你的GitHub用户名 git config --global user.email 你的GitHub注册邮箱三、 初始化本地Git仓库创建工作目录或切换到已有项目目录mkdir my-new-project cd my-new-project初始化仓库git init理解.git目录隐藏文件夹四、 Git基础添加与提交工作区、暂存区、版本库概念简述添加文件将更改纳入暂存# 添加特定文件 git add filename.py# 添加当前目录所有改动文件 git add .提交变更创建版本快照git commit -m Initial commit提交信息 (-m) 要求清晰、有意义五、 在GitHub上创建仓库登录GitHub网站点击右上角-New repository填写仓库 (Repository) 信息Repository name项目名称 (如my-new-project)Description项目描述可选Visibility公开 (Public) / 私有 (Private)Initialize this repository with暂时不勾选我们要推一个现有仓库点击Create Repository成功创建后的界面包含远程仓库地址六、 关联本地与远程仓库理解远程仓库 (Remote) 的概念获取远程仓库的URLHTTPS或SSH将远程仓库添加到本地配置git remote add origin https://github.com/你的用户名/你的仓库名.gitorigin远程仓库的默认别名检查关联是否成功git remote -v七、 推送代码到GitHub推送 (Push)将本地历史推送到远程git push -u origin main-u(--set-upstream)设置main(或master)分支跟踪origin远程的对应分支后续只需git pushmain: 默认主分支名称旧项目可能是master可能需要输入GitHub用户名和密码 (使用个人访问令牌代替密码更安全)刷新GitHub仓库页面确认代码上传成功八、 后续操作 (可选).gitignore文件作用排除不想跟踪的文件如编译产物、临时文件、密钥创建touch .gitignore编辑添加规则 (如__pycache__/,.env,node_modules/)分支管理基础 (Branching)创建分支git branch feature-branch切换分支git checkout feature-branch推送新分支git push -u origin feature-branch拉取 (Pull)同步远程更改到本地git pull origin main # 同步 main 分支克隆 (Clone)获取已有仓库到本地git clone https://github.com/用户名/仓库名.git九、 总结与资源回顾核心步骤初始化 - 添加 - 提交 - 创建远程 - 关联 - 推送命令行操作的重要性鼓励学习和掌握更多 Git 命令推荐资源GitHub GuidesPro Git (免费在线书籍)官方 Git 文档