用Git把本地代码提交到服务器,核心就四步:本地初始化并提交、配置远程仓库地址、建立分支跟踪、执行git push;服务器端提前准备好可写的裸仓库或GitLab/Gitea项目即可。你可以把Git提交理解成一次有记录的交接:本地先把改动打包成提交,再通过远程地址把提交推到服务器仓库,下面按真实操作顺序讲。
先把提交链路讲清楚:本地仓库、远程仓库和服务器各管什么
本地仓库负责记录你的每次改动,远程仓库负责团队共享和备份,服务器只是远程仓库的运行载体,可以是裸仓库,也可以是GitLab、Gitea、GitHub、Gitee这类平台。
据Git官方文档,git push会把本地提交对象传输到远程仓库,并更新远程分支引用,常见链路如下:
- 本地工作区改代码。
git add把改动放入暂存区。git commit生成一次本地提交。git remote add绑定服务器仓库地址。git push把提交推到服务器。
服务器端先准备什么
服务器端通常有两种做法,第一种是裸仓库,适合自己搭Git服务或内网部署,第二种是托管平台项目,适合团队协作和权限管理。
裸仓库方式适合有服务器登录权限的开发者,命令如下:
ssh git@your-server mkdir -p /srv/git/myapp.git git init --bare /srv/git/myapp.git chown -R git:git /srv/git/myapp.git
这里的--bare表示仓库不存放工作区文件,只保存Git数据,服务器上的仓库目录要对推送账号可写,否则会出现权限拒绝。
托管平台方式更省事,在GitLab、Gitea或Gitee新建项目,复制SSH或HTTPS地址,再回到本地执行git remote add origin 地址,据GitLab官方文档,新建项目后可直接用SSH密钥或访问令牌认证。
从零把本地代码提交到服务器:照着命令走
新手如何把本地项目上传到Git服务器
如果你本地已经有一个项目目录,按下面顺序操作:
进入项目目录,初始化仓库。
cd /path/to/your-project git init
配置提交身份,只配置一次即可。
git config --global user.name "你的名字" git config --global user.email "you@example.com"
把代码加入暂存区并提交。
git add . git commit -m "初始化项目"
绑定服务器远程地址。
git remote add origin ssh://git@your-server:22/srv/git/myapp.git
如果服务器是GitLab或Gitea,地址换成平台复制出来的SSH地址。
- 把主分支命名为
main并推送。
git branch -M main git push -u origin main
-u的作用是建立本地分支和远程分支的跟踪关系,之后直接执行git push即可。
公司内网服务器怎么用Git提交代码
公司内网场景多了一个网络和权限环节,你需要先确认三件事:服务器地址是否可达、SSH端口是否放行、推送账号是否有仓库写权限。
操作路径可以这样走:
ssh -T git@内网Git服务器 git remote -v git push -u origin main
ssh -T用来测试认证。git remote -v用来确认远程地址没有写错,内网服务器常使用非标准SSH端口,地址要写成ssh://git@host:端口/路径。
如果公司使用GitLab,通常还要在个人设置里上传公钥:
ssh-keygen -t ed25519 -C "you@example.com" cat ~/.ssh/id_ed25519.pub
粘贴到平台SSH Keys页面,行业共识认为,Git权限问题多数不是命令写错,而是密钥没加、账号没权限或仓库目录不可写。
远程地址选HTTPS还是SSH:一张表看明白
| 对比项 | HTTPS地址 | SSH地址 |
|---|---|---|
| 认证方式 | 账号密码或访问令牌 | SSH密钥对 |
| 是否免密 | 配置凭据后可免密 | 配置公钥后可免密 |
| 常用端口 | 443 | 22或自定义端口 |
| 适合场景 | 临时提交、网络受限 | 长期开发、内网仓库 |
| 常见问题 | 令牌过期、403 | 公钥未上传、权限拒绝 |
选法不复杂:个人长期开发优先SSH;公司网络限制22端口时用HTTPS;服务器自建仓库用SSH更直接,HTTPS不是不能用,关键是访问令牌要有效。
提交前容易踩的坑:分支、权限和冲突
日常提交不是每次从零开始,更常见的场景是:先拉远程更新,再提交,再推送。
git pull --rebase origin main git add . git commit -m "修复订单页空状态" git push origin main
如果团队启用了保护分支,直接推main会被拒绝,这时应该新建功能分支:
git checkout -b feature/order-empty git push -u origin feature/order-empty
然后在平台上发起合并请求,业内专家指出,团队仓库应避免所有人直接向主分支推送,保护分支加合并请求更利于代码审查。
Git提交代码到服务器和上传到GitHub有什么区别
两者底层都是Git远程仓库,区别在服务器管理方式,上传到GitHub是使用公有托管平台,仓库地址、权限、CI能力由平台提供,提交到公司服务器是使用自建Git服务或裸仓库,网络、备份、权限由团队自己维护。
区别很小:都是git remote add加git push,自建服务器更要注意目录权限、SSH端口和备份策略;GitHub更要注意访问令牌和仓库可见性。
免费Git服务器适合小团队提交代码吗
价格词落到实际,免费方案可以用,但要看边界,GitLab社区版可自建,Gitea轻量免费,GitHub和Gitee也提供免费版,免费版通常在成员数、存储、流水线时长上有约束,具体以服务商页面为准。
小团队如果代码量不大、协作人数不多,免费托管平台够用,自建免费方案省的是软件授权费,但服务器成本、备份和运维仍要投入。先看团队规模和权限要求,再决定自建还是托管。
出现报错怎么排查:按这四步走
国内服务器Git提交代码网络不稳定怎么处理
国内服务器提交代码时,网络问题常表现为推送慢、连接重置或超时,可以按顺序排查:
- 确认远程地址和端口是否正确。
- 测试SSH连通性:
ssh -T git@host -p 端口。 - 大仓库先浅克隆:
git clone --depth 1 地址。 - 公司内网让运维放行Git端口或安全组。
- 临时切换HTTPS地址提交。
如果使用云服务器,安全组要放行SSH端口,自定义端口时,远程地址也要同步改端口,不能只改本地配置。
推送被拒绝时先看什么
看到rejected不要急着重装Git,先执行:
git pull --rebase origin 分支名 git status
解决冲突后:
git add 冲突文件 git rebase --continue git push
如果提示non-fast-forward,说明远程有你本地没有的提交,先同步再推,如果提示Permission denied,检查公钥、账号权限和仓库目录权限。
怎么用git把本地代码提交到服务器的Q&A
怎么用git把本地代码提交到服务器时提示Permission denied怎么办
先分两类,SSH方式执行ssh -T git@服务器,确认公钥是否生效,HTTPS方式检查访问令牌是否过期,裸仓库还要确认仓库目录对推送账号可写,例如chown -R git:git /srv/git/myapp.git,权限问题解决后,再执行git push -u origin main。
git push成功但服务器仓库看不到代码是什么原因
裸仓库本来就没有工作区文件,直接在服务器目录里看不到源码是正常的,可以用git --git-dir=/srv/git/myapp.git log --oneline查看提交记录,如果服务器是部署目录,需要额外配置检出或钩子,把仓库内容同步到网站目录。
怎么用git把本地代码提交到服务器并指定分支
先确认本地分支名,再推送并建立跟踪:
git checkout -b feature/login git push -u origin feature/login
如果远程分支已存在,用git push origin 本地分支:远程分支,推送完成后,用git branch -vv查看跟踪关系,用git remote -v核对远程地址。
把本地代码提交到服务器,真正要盯住的是远程地址、认证权限和分支跟踪这三件事。 命令本身不复杂,按链路准备服务器仓库,再按add、commit、remote、push顺序执行,多数场景都能一次跑通。
首发原创文章,作者:王坚,如若转载,请注明出处:https://idctop.com/article/799712.html


