企业官网建设流程全解析

早些年我刚用Git的时候，一直觉得“连接远程仓库”是件很玄乎的事——明明装好了Git，本地随手add、commit都很顺，一到push就各种报错。后来在华为软件开发云（现在更多叫华为云DevCloud）上折腾了几个项目，把整套流程摸透之后发现，核心就三件事：账号和仓库准备好、本机装好Git并配好身份、用SSH或HTTPS把两端连起来。这篇文章我就围绕“Git连接华为软件开发云”这件事，从零开始把完整过程拆开讲，Windows、macOS、Linux三种系统的安装方式都会带到，还会把我在真实环境里踩过的坑全部列出来。

这篇内容适合三类人：刚接触Git、想找一个国内访问速度快的代码托管平台来放个人项目的新手；公司或团队准备用华为云DevCloud做开发协作、需要把代码迁过去的开发者；以及已经用过GitHub/Gitee、想快速熟悉另一个平台连接方式的同学。读完你不仅能连上仓库，还能理解每一步为什么要这么做，后面遇到问题也知道从哪查起。

1. 先搞懂为什么要连：华为软件开发云里的代码托管

1.1 华为软件开发云的代码托管到底是什么

很多人在标题里搜“git连接华为软件开发云”，其实想做的事情很简单：把本地的Git仓库推到华为云的服务器上托管，这样代码不会丢、方便团队一起开发、还能和平台的持续集成打通。华为软件开发云早期是一个独立的产品线，后来整合进了华为云DevCloud，其中负责代码托管的服务叫CodeHub，本质就是一个标准的Git远程仓库服务。

也就是说，你用本地的git命令操作它，和操作GitHub是同一套逻辑。远程仓库在你的账号下，本地通过git remote指向它，之后clone、pull、push都是Git原生操作。平台上的网页只是给你一个可视化的查看入口：能看到提交历史、分支关系、合并请求、代码评论等等。

明白了这层关系，你就不会被各种花哨的概念绕晕。连接这件事，本质上就是“让本地的Git知道远端是谁、以及远端认不认你这个用户”。前者靠仓库地址，后者靠认证信息。

1.2 SSH与HTTPS：两种连接方式怎么选

华为云DevCloud的代码仓库支持两种连接协议：HTTPS和SSH。很多教程默认让你用其中一种，但实际应该根据场景选。

我自己的建议是：在经常开发的电脑上，一律用SSH，一次配置长期省心。如果你的公司电脑有一些安全管控，不允许生成SSH密钥，那就用HTTPS配合访问令牌（Access Token），别直接用登录密码，权限更细也更安全。后面核心实操部分我会把SSH这条线走完整，HTTPS的做法也顺带提一下。

2. 开工前的准备：账号、仓库和本地Git环境

2.1 注册华为云账号并开通DevCloud

连接华为软件开发云的第一步是在华为云官网注册一个账号，然后做实名认证。个人使用的话，实名认证的方式支持身份证信息认证，也可以扫脸，过程很快。企业用户选企业认证，但如果你只是自己搭个实验环境，个人认证完全够用了。

登录后进入控制台，在搜索框里输入“DevCloud”就能找到软件开发平台。第一次进来会引导你创建一个企业/项目空间，你可以理解为一个隔离的组织，下面可以建多个项目。这一步不用纠结，名字之后都能改，先起一个和业务相关的名字进去再说。

2.2 创建项目和代码仓库

进入DevCloud后，在“项目”里创建一个新项目，项目模板我一般选Scrum，方便后面管理需求和迭代。如果你纯是为了放代码，选“看板”也行。项目创建完成后，左侧菜单找到“代码”->“代码托管”，点进去即可创建仓库。

创建仓库时有几个选项需要注意：

• 仓库名称：对应远程URL里的一个路径，建议全小写，用中划线连接，例如my-project。
• 初始化设置：新手建议勾选“初始化仓库”并添加一个README.md，这样仓库会有一个默认的main分支，clone下来直接能用。如果不初始化，远端是空仓库，本地首次推送时要额外注意分支匹配。
• 可见范围：个人项目选私有，避免代码被公开浏览。

仓库创建后，页面会跳转到仓库主页。右上角通常有一个“克隆/下载”按钮，点开能看到SSH和HTTPS两套地址。先别急着复制，后面我们会按场景用它。

2.3 本地安装Git：Windows、macOS、Linux全跑一遍

既然搜索热词里“git安装”占了很大比重，我把三种系统的安装写细一点。

Windows

最省事的方式是去Git官网下载Windows安装包，或者用国内镜像（比如清华的开源镜像站），速度更快。下载之后一路Next，但有两个选项值得花10秒看一眼：

• 在“Adjusting your PATH”这一步，选“Git from the command line and also from 3rd-party software”，这样你在cmd和PowerShell里都能直接用git命令。
• 在“Configuring the line ending conversions”这一步：如果团队以Linux/macOS为主，选“Checkout as-is, commit Unix-style line endings”最不容易出问题；如果你主要在Windows上开发，选第一项“Checkout Windows-style, commit Unix-style line endings”也行。我的习惯是选第三项，避免换行符引发的批量变更。

其他配置保持默认，安装完成后打开PowerShell或cmd，输入git --version验证。能看到版本号，说明装好了。

macOS

Mac上最简单的方式是打开终端，执行xcode-select --install，会安装Command Line Tools，里面自带Git。如果你装了Homebrew，也可以brew install git，这样拿到的是较新的独立版本。两种方式都行，之后验证一下git --version即可。

Linux

Debian/Ubuntu系：

sudo apt update sudo apt install git -y

CentOS/RHEL/Fedora系：

sudo yum install git -y

装完还是一样，先执行git --version。Linux上如果是从源码编译安装，问题会更多一些，但绝大多数发行版的软件源里都有现成Git，直接用就行。

2.4 全局身份配置：提交者名字和邮箱

Git每次提交都需要知道你是谁。安装完Git后，第一件事不是去连接远端，而是配置身份：

git config --global user.name "你的名字" git config --global user.email "你的邮箱"

这里有个细节：邮箱最好和华为云账号绑定的邮箱一致，或者至少是团队里大家能认出你的邮箱。因为提交记录里显示的就是这两项，如果随便填，代码评审时别人认不出是谁提交的。配置完可以用下面的命令确认：

git config --global --list

配置信息保存在你的用户目录下的.gitconfig文件里，比如Windows是C:\Users\你的用户名\.gitconfig，macOS/Linux是~/.gitconfig。如果哪次提交发现作者不对，直接改这个文件也行。

3. 打通连接：从SSH密钥到首次推送

3.1 生成SSH密钥对并配置到平台

现在进入真正的连接环节。SSH方式连接的核心思路是：你本地生成一对密钥，公钥上传到华为云，私钥留在自己电脑上。推送代码时，远端拿公钥验证本地持有对应的私钥，验证通过就放行。

生成密钥的命令：

ssh-keygen -t rsa -b 4096 -C "你的邮箱"

解释一下参数：-t rsa指定算法为RSA，-b 4096指定密钥长度为4096位，-C是一个注释，通常填邮箱用来区分多台电脑。执行后终端会问保存路径，默认是~/.ssh/id_rsa，直接回车。然后又问是否设置passphrase（密钥口令），我建议个人开发机可以留空直接回车，省得每次都要输入；如果公司有安全要求，就设置一个，配合ssh-agent使用体验也没那么差。

密钥生成后，默认会在家目录的.ssh文件夹里产生两个文件：

• id_rsa：私钥，绝对不能发给任何人，也不要上传到任何平台。
• id_rsa.pub：公钥，可以公开，就是要给华为云保存的。

查看公钥内容，Windows在PowerShell里执行：

type $env:USERPROFILE\.ssh\id_rsa.pub

macOS/Linux执行：

cat ~/.ssh/id_rsa.pub

终端会打印一串以ssh-rsa开头的内容，把它完整复制下来。然后回到华为云DevCloud页面，在右上角头像进入“个人设置”，找到“SSH公钥”管理，新建一条公钥记录，把刚才复制的内容粘贴进去，取一个能看出是哪台电脑的名字。

到这里，SSH密钥对就算配完了。

3.2 把远程仓库拉下来（clone）

新建的仓库如果勾选了初始化，远端已经有内容了。现在你可以回到本地，找一个工作目录，执行克隆操作。仓库页面的“克隆/下载”按钮会给你地址，用SSH方式你得到的大概是这种形式：

git clone git@codehub-cn-north-4.xxxxx:项目名/仓库名.git

第一次克隆时，系统会提示确认主机指纹，输入yes回车即可。克隆完成后，进入目录用git log能看到远端初始化的提交记录，说明连接已经通了。你可以在本地任意改动、提交，然后push回远端。

如果你用的是HTTPS方式，git clone时输入账号密码，然后使用访问令牌而不是登录密码会更稳。华为云支持在“个人设置”里生成Access Token，克隆时密码处粘贴这个Token即可。

3.3 本地已有项目怎么关联远端

仓库是空的，或者你本地已经有一个不带Git配置的项目，就需要手动初始化并关联远端。假设你的项目目录叫my-project：

cd my-project git init git remote add origin git@codehub-cn-north-4.xxxxx:项目名/仓库名.git

注意看当前分支名。新版Git的git init初始分支可能是master，也可能受全局配置影响。华为云新建仓库默认主分支是main，为避免后面“拒绝推送”的问题，先把本地分支改名：

git branch -M main

然后添加文件并提交：

git add . git commit -m "init project" git push -u origin main

-u参数会把本地main分支和远端main分支关联起来，之后直接git push就能推送，不用每次写分支名。这是很多新手容易漏掉的一步。

3.4 一次真实的“改代码-提交-推送”全流程

连接配置好之后，日常开发就是重复下面这个流程。我用一个例子带大家走一遍：假设你刚修改了一个前端页面文件index.html。

git status

先查看工作区状态，能清楚看到哪些文件被修改。红色表示未暂存，绿色表示已暂存。然后：

git add index.html git commit -m "feat: 修改首页标题" git push

如果推不上去，十有八九是远端有了新提交。最稳妥的做法是先把远端变化拉下来，再推：

git pull --rebase git push

用--rebase而不是默认的git pull，会让本地未推送的提交“叠”在远端提交之后，历史是直线，不会有乱七八糟的merge节点。这句命令值得记下来，很多线上冲突都是这么平的。

如果只是看看提交历史，用：

git log --oneline

4. 连接过程中常见问题排查实录

连接和推送这部分，我见过的报错翻来覆去就那么几类。下面按现象整理成一张速查表，再逐个细说。

4.1 SSH认证失败类问题

报错里出现Permission denied (publickey)，基本就是认证这环出了问题。排查顺序我建议这样走：

• 确认公钥是否完整粘贴到平台，特别注意有没有漏掉结尾的标识符。
• 确认本机使用的是不是正确的私钥。很多人电脑里可能有多个密钥，系统默认只找id_rsa，你生成时如果换过名字，需要在~/.ssh/config里指定。
• 如果私钥设置了passphrase，当前shell里可能没记住，执行eval "$(ssh-agent -s)"再ssh-add ~/.ssh/id_rsa加入缓存。
• 检查复制的仓库地址是不是SSH开头，有的同学复制了HTTPS地址但试图用SSH去连，自然连不通。

可以用ssh -T命令做连通性测试，主机名就取你复制的SSH地址里git@后面那段：

ssh -T git@codehub-cn-north-4.xxxxx

出现欢迎语说明认证成功，否则多半还是密钥的问题。

4.2 推送被拒绝与分支名不一致

error: failed to push some refs这个报错，本质是远端有你这个分支上不存在的提交。最简单的原因就是你没pull就push。解决思路刚才提过：

git pull --rebase git push

另一种情况是你本地分支叫master，远端叫main，且两个仓库还没有关联关系。这时要么用git branch -M main改本地分支名，要么在push时指定git push origin master:main。新手阶段建议直接统一成main，和平台默认值保持一致，省得每次都要带映射。

4.3 仓库关联异常与重复origin

命令行提示fatal: remote origin already exists.，说明当前目录已经有一个关联的远端地址。用git remote -v查看现状：

git remote -v

如果地址不对，改掉：

git remote set-url origin 新的仓库地址

如果这个磁盘目录不需要旧关联，直接删掉：

git remote remove origin

注意git remote remove origin会连关联关系一起删，不影响任何提交和代码，只删除本地对远端的指向，可以放心操作。

4.4 大文件、忽略规则与缓存类问题

华为云DevCloud对单个文件大小和仓库整体容量都有建议阈值。代码仓库不该承担二进制大文件，比如安装包、数据集、压缩包。遇到这种需求，要么用平台的文件共享存储，要么在云硬盘里另建目录存放。

另一个常踩的坑是.gitignore看起来写了规则却不起作用。原因是某些文件已经被Git追踪了，忽略规则对已追踪文件无效。解决办法是把它们从索引中移除：

git rm -r --cached . git add . git commit -m "chore: 重置缓存并应用gitignore"

在生产项目里，我通常会在仓库根目录放一个.gitignore，至少包含这几类：

# 编译产物 target/ dist/ build/ *.class # 依赖目录 node_modules/ vendor/ .venv/ # 本地环境配置 .env .idea/ .vscode/ *.iml # 日志和临时文件 *.log *.tmp .DS_Store

4.5 网络连接与证书问题

如果clone或push时直接卡住，或提示超时，先确认网络到平台是否通畅。有些公司内网会限制22端口的SSH流量，这时候改用HTTPS地址往往能绕开端口限制；反过来，如果HTTPS提示SSL certificate problem，多半是公司网络环境的证书链不被Git信任，需要找管理员要机构CA证书配置到Git的http.sslCAInfo里，或者临时用git config --global http.sslVerify false绕过——但后者不安全，我不建议在公共环境用，更不建议长期开启。

还有一个细节：如果之前配置过代理导致clone失败，检查一下：

git config --global --get http.proxy git config --global --unset http.proxy

代理设置为空反而是最正常的状态。如果你不确定有没有配置过，用git config --global --list扫一眼。

5. 连接只是起点：代码托管该养成的好习惯

5.1 提交信息写清楚

很多人刚连上远端时，commit记录里全是update、aaa、111这种信息。等过一个月回看，完全不知道当时改了什么。我的习惯是采用类似类型: 简要说明的写法：

feat: 新增用户登录接口 fix: 修复购物车数量显示错误 docs: 更新README部署说明 chore: 升级依赖版本

这样无论是自己翻历史、做代码评审，还是配合华为云DevCloud的需求关联，都一目了然。

5.2 小步提交，别攒大招

有个经典误区是：一天写完功能，最后一次性add、commit、push。原因是中途出了bug很难定位是哪个改动引入的。我建议每个逻辑单元独立提交，比如“改好一个接口就提交一次”，哪怕这个提交还没推送到远端也没关系。每次提交都应该是一个完整、可运行的版本，别人拿到这个commit能独立工作，不会出现“提交时编译都过不了”的尴尬。

5.3 版本标签和分支保护

代码托管不只是为了存代码，还要方便发布。项目快上线时，我会给版本打个标签：

git tag v1.0.0 git push origin v1.0.0

这样以后无论发哪个版本，都能从标签切出对应代码，不会被后面新功能污染。

在DevCloud的项目设置里，还可以为主分支开启“保护分支”。开启后直接push会被拒绝，必须通过合并请求合并。虽然多了一步，但对团队项目来说，这是防止手滑把坏代码推到主分支的最有效手段。个人项目如果只有你一个人，保护分支反而碍事，可以不开。

5.4 用合并请求做代码评审

当团队超过两个人时，建议不要所有人都在main分支上直接提交。可以用本地开分支、推送到远端、然后创建合并请求的方式：

git checkout -b feature-login git push -u origin feature-login

然后在DevCloud网页上发起合并请求，把feature-login合并到main，请同事在网页上评审。这一步能拦截掉大量低级错误，而且评审记录会永久留在平台上，比在微信群里发代码截图规范得多。

5.5 再往后走一步：连上流水线

代码成功推到远程仓库后，你其实已经完成了“连接”的核心目标。但华为云DevCloud的价值不止一个代码托管。平台提供了流水线，可以把“代码推送”作为事件触发自动构建、自动部署。你只管push，测试环境甚至生产环境的发布流程都交给流水线跑。这也是为什么我一直强调第一步把SSH和分支模型理清楚——后面所有自动化都建立在规范的代码托管之上。

回到开头的那个问题：Git连接华为软件开发云难不难？真不难。账号准备好，仓库建好，本机装好Git配好身份，再从SSH密钥、clone、pull、push这条路径走一遍，连接就算彻底打通了。我自己的体会是，连接之后最值得花时间的不是熟悉更多命令，而是把提交信息写规范、把分支模型定清楚、把保护分支合并请求用起来。这几点做好了，平台本身只是个载体，真正提升效率的是你围绕它形成的开发习惯。