github如何上传项目:两种实操方案
github如何上传项目包含网页拖拽上传和Git命令行推送两种方式,网页端适合文件总量较小、不需要长期版本迭代的临时项目,无需安装Git软件,直接浏览器操作;命令行适合完整项目、需要持续更新代码的开发场景,必须先在电脑安装Git,GitHub单次推送文件上限为2GiB,超过该限制无法一次性上传,适合具备基础终端操作能力的开发者。操作前都要先登录GitHub账号,新建空白仓库,复制仓库地址,仓库创建时不要勾选初始化README文件,否则本地推送会出现分支冲突。
github如何上传项目:网页端操作
进入新建好的GitHub仓库主页,点击页面上方Addfile下拉菜单,选择Uploadfiles选项,直接把本地项目文件夹拖拽进浏览器窗口,也可以点击选择文件手动选中项目内容。页面底部填写提交备注,简单描述本次上传内容,选择直接提交到main主分支,点击Commitchanges完成上传。网页上传不支持保留本地完整git版本记录,多层文件夹结构较多时,容易出现部分文件上传失败的情况,适合几十MB以内、仅做代码备份的轻量项目。
网页上传无法处理大项目。
github如何上传项目:Git命令行推送
打开终端或者GitBash,cd切换到本地项目文件夹目录,输入gitinit初始化本地仓库,这条命令会在项目内生成隐藏.git文件夹,用于保存版本记录。接着输入gitadd.,把当前目录全部文件加入暂存区,句号代表全部文件,你也可以替换成单独文件名只上传指定内容。运行gitcommit-m"首次上传项目",引号内是本次提交说明,记录本次变更信息。执行gitremoteaddorigin仓库HTTPS地址,把本地仓库和GitHub远程仓库建立关联,地址在GitHub仓库主页绿色Code按钮处复制。最后运行gitpush-uoriginmain,将本地代码推送到远程main分支,首次推送需要身份验证,HTTPS方式需填写个人访问令牌,不能直接使用账号密码。
| 上传方式 | 前置条件 | 适用项目大小 | 版本管理能力 |
|---|---|---|---|
| 网页拖拽上传 | 浏览器,GitHub账号 | 小于50MB | 弱,无本地版本历史 |
| Git命令行推送 | 本地安装Git,配置账号信息 | 单次不超过2GiB | 强,完整版本回溯 |
项目根目录新建.gitignore文件,写入不需要上传的文件名称,比如node_modules、日志文件、本地配置密钥,执行gitadd时会自动跳过这些内容,避免把敏感配置、依赖包上传到公开仓库,减少仓库体积,也防止隐私信息泄露。密钥、数据库账号这类敏感内容一旦上传公开仓库,即使后续删除,历史提交记录仍可被他人查看,需要单独清理提交记录。
仓库创建时勾选README初始化,本地直接推送会触发分支历史冲突,报错提示fatal:refusingtomergeunrelatedhistories,解决方法是删除本地.git文件夹重新初始化,或者添加参数允许合并不相关历史,这个操作会增加仓库版本冗余,一般优先选择新建空白仓库不初始化README。
身份验证环节,GitHub在2021年停止支持HTTPS密码登录,你需要在GitHub账号设置页面生成个人访问令牌,令牌权限勾选repo相关权限,推送代码时,弹窗输入密码的位置粘贴令牌字符串,令牌只会显示一次,丢失需要重新生成。
- 不要上传大于2GiB的单个压缩包,超出GitHub单次推送限制
- 公开仓库上传代码前,移除硬编码的密钥、接口凭证
- 项目路径不要使用中文和特殊符号,降低Git识别异常概率
- 首次推送后,后续更新仅需重复gitadd、gitcommit、gitpush三条命令
推送完成后刷新仓库网页,就能看到全部本地项目文件。后续修改代码,重复暂存、提交、推送流程,GitHub会自动保存每一次代码改动记录,支持查看文件修改差异,回退到历史版本,满足长期迭代开发的代码托管需求。
