互联网教程

代码怎么托管到 Gitee / GitHub

代码托管不只是「存代码」,它是版本管理、协作、发布与回滚的基础。没有仓库的项目,改坏了只能靠记忆恢复。

发布者:黔序科技依据官方文档核验:2026 年 11 月

核心结论

  • 私有仓库起步,别把密钥提交上去
  • 用分支管理发布,主分支保持可部署
  • .gitignore 先写好,密钥与依赖不入库

一句话:最小可用的规范:一个仓库一个项目、私有仓库、主分支可部署、改动走分支、密钥不进库。做到这四条,协作与回滚都不会乱。

初始化步骤

  1. 建远程仓库在 Gitee 或 GitHub 新建私有仓库,不要勾选自动生成 README(避免首次推送冲突)。
  2. 本地初始化git init 后写 .gitignore,排除 node_modules、target、.env、日志。
  3. 配密钥用 SSH key 而不是密码,公钥加到平台,私钥留在本地。
  4. 提交并推送首次提交后关联远程并推送,确认分支为 main 或 master。
  5. 保护主分支开启分支保护,禁止直接推送,改动走合并请求。

注意:把 .env、数据库释密码、云 AccessKey 提交到仓库,是事故排行榜第一名。即便后来删除,历史提交里仍能翻出来。一旦泄露要立刻轮换密钥,改代码不算修复。

分支与发布

  • main:随时可部署的稳定版本。
  • dev:集成分支,日常开发合并到这里。
  • feature/*:单个功能或修复,完成后合并回 dev。
  • tag:每次上线打一个 tag,出问题能精确回到某次发布。

常见问题

  • 推送被拒:远程有本地没有的提交,先 pull --rebase 再推。
  • 文件太大推不上去:依赖或构建产物被提交了,从 .gitignore 排除并用 git rm --cached 移除。
  • 误提交密钥:立即轮换密钥,再用 filter-repo 清理历史;只删除文件不清理历史无效。

部署联动

可以用平台的 Webhook 或 CI 做自动部署:推送到主分支 → 拉取代码 → 构建 → 重启服务。自动部署要加人工确认环节,否则一次误推就直接上线。

资料来源

  • Git 官方文档:分支、合并与 tag 管理。
  • Gitee / GitHub 文档:SSH 密钥配置与分支保护。
  • OWASP《密钥管理备忘单》:凭证不入代码库。

常见问题

代码放 Gitee 还是 GitHub?

国内团队用 Gitee 访问快、合规沟通方便;有海外协作或开源需求用 GitHub。私有项目两者都行,关键是别放公开仓库。

服务器上怎么拉代码?

在服务器生成 SSH key 并加到平台的部署公钥(只读权限),用 git pull 拉取。不要用个人账号密码,也不要把私钥传到服务器以外的地方。

要不要给客户开源代码?

按合同约定。通常交付源码但不上公开仓库,客户拿到的是私有仓库权限或打包代码,避免被二次分发。

相关阅读