本教程详细介绍如何将本地项目通过Bash 终端上传代码到 GitHub准备工作1. 安装 Git一款免费、开源的「本地版本管理工具」只负责一件事追踪你文件夹里所有文件的修改、保存版本、记录改动。winget install Git.Git集成右键上下文菜单参照→bash右键.reg外观设置打开终端后在标题栏右键选择“选项”→窗口窗口建议调整至合适的大小界面语言也可以在这里更改。。此外默认字体可能较小请选择合适的字体及大小。若觉得背景不舒适可从内置主题中选择喜欢的背景。推荐的主题dracula—推荐tender—棕色背景monokai-dimmed–灰色xterm、mintty—蓝色rosipov—黑色背景kohlrausch–米色2. 配置 Git 用户信息gitconfig--globaluser.name你的GitHub用户名gitconfig--globaluser.email你的GitHub邮箱3. 生成 SSH 密钥可选推荐ssh-keygen-ted25519-C你的邮箱然后将~/.ssh/id_ed25519.pub的内容添加到 GitHub → Settings → SSH Keys4.Git 全局配置改成默认 maingit config --global init.defaultBranch main5.检查是否配置成功git config --list上传步骤方法一命令行上传推荐1. 初始化 Git 仓库进入项目目录初始化仓库cd/path/to/your/projectgitinitgitinit-bmain#初始化 main 分支2. 添加文件到暂存区gitadd.或者添加指定文件gitaddREADME.md3. 提交改动gitcommit-mfirst commit4. 创建远程仓库并上传一条命令 网页建仓 手动关联远程 首次推送。也就是说会全自动在GitHub 网页端创建一个空私有仓库名字默认和当前文件夹同名自动帮你把本地关联到远程 origingh repo create --source. --private --push自定义仓库名gh repo create 你想要的仓库名 --source. --private --push5. 查看你的仓库地址git remote -v方法二命令行上传1. 初始化 Git 仓库进入项目目录初始化仓库cd/path/to/your/projectgitinit2. 添加文件到暂存区gitadd.或者添加指定文件gitaddREADME.md3. 提交改动gitcommit-mfirst commit4. 在 GitHub建空仓库访问 https://github.com/new 创建空仓库不要勾选README Initialize this repository with:获取仓库地址格式如HTTPS:https://github.com/用户名/仓库名.gitSSH:gitgithub.com:用户名/仓库名.git5. 关联仓库gitremoteaddorigin https://github.com/用户名/仓库名.git6. 推送到 GitHubgitpush-uorigin master如果是 main 分支gitpush-uorigin main方法三使用 gh CLI1. 安装 ghwinget install GitHub.cli2. 登录 GitHubgh auth login按提示选择GitHub.com → YesHTTPS → Yes登录方式 → GitHub CLI3. 创建仓库并推送cd/path/to/project gh repo create my-repo--public--source.--push或者分步操作gh repo create username/my-repo--publicgitremoteaddorigin https://github.com/username/my-repo.gitgitpush-uorigin master方法四使用 GitHub Desktop下载 GitHub Desktop: https://desktop.github.com/登录 GitHub 账号File → Add Local Repository选择项目文件夹点击 “Publish repository”常用命令速查在你原有表格基础上无缝扩充、格式统一、极简好记直接复制即用命令说明git status查看仓库修改、暂存、文件状态git add .添加全部改动文件到暂存区git add 文件名添加指定单个文件到暂存区git commit -m 信息本地提交改动填写备注说明git remote -v查看已关联的远程仓库地址git push推送本地代码到远程默认分支git push origin main强制指定推送到远程 main 分支git pull拉取远程仓库最新代码并合并git pull origin main拉取远程 main 分支最新代码git log查看完整本地提交历史记录git log --oneline精简一行式查看提交历史git branch查看本地所有分支git branch -m master main将本地 master 分支重命名为 maingit remote add origin 仓库地址手动关联远程 GitHub 仓库git fetch仅拉取远程更新、不自动合并git reset撤销暂存区保留本地文件修改git init初始化全新本地 Git 仓库常见问题Q:一键推送的BAT脚本编写拿Snaply项目示例新建文本文档粘贴下面代码后缀改成.bat放到Snaply文件夹里即可。echo off chcp 65001 :: 进入项目根目录 cd /d D:\project2026\github\Snaply :: 拉取远程最新避免冲突 git pull :: 添加所有变更 git add . :: 自动获取时间作为提交备注 set commit_msgauto update: %date% %time% git commit -m %commit_msg% :: 推送到远程 main 分支 git push origin main echo. echo echo 推送完成 echo pause远程分支还是master只需要把最后一行改成git push origin master不需要 pull纯快速推送echo off chcp 65001 cd /d D:\project2026\github\Snaply git add . git commit -m auto commit git push echo 推送完毕 pauseQ:本地远程仓库变成普通文件夹.git 也被标记为隐藏文件可以执行ls -a查看删删掉根目录下的隐藏 .git 文件夹rd /s /q .gitQ:本地IPS文件夹 → 初始化 → 建主分支 → 新建多个分支 → 全部推送到 GitHub全程复制即用。日常开发中不要直接在主分支 main 上修改代码开发新功能、修复漏洞、测试新方案、迭代版本时都要新建独立分支隔离操作避免改动影响稳定主线仅轻微修改文档、注释或确定无误的简单配置时可直接在主分支编辑无需新建分支。示例本地IPS项目文件夹# 1. 进入你的 IPS 项目根目录 cd /c/你的路径/IPS # 2. 初始化git仓库 git init # 3. 绑定全局用户信息(仅首次配置) git config --global user.name GitHub用户名 git config --global user.email GitHub绑定邮箱 # 4. 暂存所有文件 首次提交 git add . git commit -m 初始化IPS项目基础文件 # 5. 设置主分支为 main git branch -M main # 6. 关联远程GitHub仓库替换成你自己的仓库地址 git remote add origin https://github.com/xxx/xxx.git # 7. 推送主分支 main git push -u origin main # ---------- 新建多个分支 开始 ---------- # 新建并切换到 dev 开发分支 git checkout -b dev # 提交一次空记录保证分支完整可推送 git commit --allow-empty -m 初始化dev分支 # 推送dev到远程 git push -u origin dev # 新建并切换到 test 测试分支 git checkout -b test git commit --allow-empty -m 初始化test分支 git push -u origin test # 新建并切换到 fix 修复分支 git checkout -b fix git commit --allow-empty -m 初始化fix分支 git push -u origin fix # 切回主分支 git checkout mainQ:当前的 master 分支改成 main# 1. 把本地 master 重命名为 main git branch -m master main # 2. 让本地 main 分支关联远程 main自动创建远程 main git push -u origin main # 3. 删除远程的旧 master 分支可选干净一点 git push origin --delete masterQ: 提交后想撤销gitreset--softHEAD~1Q: 修改了远程仓库地址gitremote set-url origin 新地址Q: 推送到另一个分支gitpush origin master:developQ: 每次推送都要输入账号密码推荐使用 SSH 方式或配置 Credential Helpergitconfig--globalcredential.helper store