前阵子帮一位刚开始用GitCode的读者排查问题他的处境我印象很深仓库在网页上建好了本地文件也顺利推了上去结果过了两天换了台电脑打算继续提交代码发现自己怎么都想不起密码。GitCode给出的login failed提示让他一度以为是仓库没了。其实不是。先说一个容易误解的地方这里说的建仓指的是在GitCode上创建代码仓库repository不是金融投资里那个建仓。代码仓库是存放项目文件并记录每次修改历史的地方GitCode就是帮你托管这些仓库的在线平台。对绝大多数个人开发者来说核心动作无非就是网页上建仓、本地把文件传上去、日后持续提交更新而最容易被劝退的恰恰不是操作本身而是密码忘了、凭据缓存在捣乱、分支名对不上这些边角料问题。这篇文章把GitCode建仓、上传本地文件、忘记密码的完整处理路径连起来讲一遍既覆盖网页端操作也覆盖本地Git命令、Windows凭据管理和SSH免密配置。适合刚接触Git、第一次用GitCode以及被各种认证报错折腾过的人。1. 建仓之前的三件小事平台差异、可见性和初始化选项1.1 为什么选GitCode而不是GitHub或GiteeGitCode算是国内用得比较多的代码托管平台和GitHub、Gitee属于同一类产品。对大部分个人开发者来说选GitCode的核心原因就两个第一是访问速度国内网络环境下打开网页、拉取和推送代码都更顺畅不会出现某些境外平台时灵时不灵的情况第二是免费私有仓库个人项目、学习笔记、甚至暂时不方便公开的代码都可以直接放进私有仓库。也有朋友会问Gitee同样快干嘛非得用GitCode这就看习惯了。GitCode的界面和交互比较接近GitLab合并请求、Issue、项目文档这些日常功能都有社区里还能找到不少开源项目的镜像。我实际用下来的感受是它对新手比较友好建仓成功后会直接在当前页面给出下一步要执行的Git命令比让新手对着一个空仓库发呆要省心得多。1.2 仓库可见性公开还是私有建仓那一刻就要决定建仓之前先想清楚这个仓库是公开还是私有。GitCode的私有仓库免费所以很多人直接无脑选私有。这个选择本身没错但如果你希望把代码展示给别人、给简历加分或者想开源某个工具就一定要选公开。公开仓库能被搜索引擎收录别人访问你的GitCode主页就能看到项目私有仓库只有你自己和主动添加的协作者能访问。这里有个细节仓库可见性之后虽然也能改但改起来会牵涉到已有成员、Star、Fork这些历史关系建议建仓时就定好别想着先私有过阵子再公开。另外仓库名尽量不要用中文和空格用短横线分隔的小写英文最省事比如my-blog、data-analysis-scripts。因为仓库名是克隆地址的一部分等推了一堆文件再改名远端地址变了本地还得重新关联麻烦指数直接翻倍。1.3 建仓时的初始化选项README、.gitignore和开源协议GitCode建仓页面会给几个初始化选项README文件、.gitignore模板、开源协议。很多新手怕麻烦全部跳过我的建议是至少勾上README和.gitignore。README是仓库的门面别人点进仓库第一眼看的就是它。哪怕一开始没什么内容先放上项目名称和一句简介后面慢慢补就好。.gitignore的作用是让Git自动忽略不需要提交的文件比如IDE的配置目录、编译产物、临时日志。如果你本地用的是PyCharm、VS Code这类编辑器建仓时顺手选一个对应语言的.gitignore模板能省掉日后怎么把这么大一堆无用文件也推上去了的尴尬。开源协议这个选项新手可以暂时不选。真要开源的时候再补不迟不熟悉协议含义的情况下选了反而可能给自己挖坑。建仓界面的核心字段其实就两个仓库名和可见性我还会顺手把仓库描述也填上让项目在自己的仓库列表里更好认。2. 本地Git环境准备安装、全局配置和验证一步都别省2.1 Windows下安装Git的两种方式GitCode网页端的操作再简单最终上传本地文件还是要靠本地的Git程序。Windows下安装Git最标准的方式是到Git官网下载安装包一路Next装完。如果官网下载速度不理想也可以用国内镜像下载速度会快很多。安装完成后打开终端Windows Terminal、PowerShell、CMD都行输入git --version验证能看到类似于git version 2.x.x.windows.1的输出就说明安装成功了。我见过不少人装完Git之后完全忘了验证直到执行git add才收到git不是内部或外部命令的提示白折腾半天。如果出现这种情况多半是安装时没有把Git加入PATH或者安装完没有重开终端导致环境变量没刷新。重开终端通常就能解决实在不行就在安装包里勾选Add to PATH重新装一遍。安装包默认会附带Git Bash这是一个模拟Linux命令行的终端工具网上很多旧教程默认你用它。我个人建议日常直接用PowerShell或Windows Terminal命令习惯是一致的没必要多开一个窗口。当然如果Git Bash你用得顺手用它也没问题下面所有命令在Git Bash里同样适用。2.2 全局配置user.name和user.email这一步真的不能省装好Git之后第一件事不是急着建仓而是先做全局配置。Git每次提交都要知道是谁在提交没有用户名和邮箱git commit执行时会直接报错要求你补上身份信息。git config --global user.name 你的名字 git config --global user.email 你注册GitCode用的邮箱 git config --global init.defaultBranch main前两条是身份信息邮箱务必用注册GitCode的那个否则提交记录里的邮箱对不上平台统计贡献时会漏掉你。第三条是我强烈建议顺手配置的它会把本地新建仓库的默认分支名统一成main避免以后push时本地master和远端main不一致的尴尬。这个问题我后面第5章还会专门讲第一次遇到的人几乎都会愣住。如果你有多台电脑每台都要执行一遍这套配置。别觉得麻烦漏掉任何一台那台电脑后续提交都会出问题。2.3 验证配置git config --list的输出怎么看配置完成之后用git config --list可以打印出当前所有配置项。在输出里确认user.name、user.email、init.defaultBranch三项都在说明配置生效了。这里有个容易混淆的点git config --list列出的内容可能来自三个层级——系统级、全局级、仓库级。如果同一个配置出现了多次后面读取到的会覆盖前面的。我们刚设置的是--global全局级作用于当前用户的所有仓库。仓库级配置存放在项目目录下的.git/config文件里相对不常用不熟悉的时候别手动去改它。配置验证完本地环境基本就绪了。现在可以进入正题建仓和上传。3. 上传本地文件的标准流程从网页建仓到git push3.1 网页端建仓点哪个按钮、填哪些字段登录GitCode找到新建仓库入口就进入建仓页面了。填仓库名的时候平台会提示哪些字符可用。按第1章说的命名规则来基本不会出错。仓库描述可填可不填填了在项目列表里更好认别人访问时也能快速了解项目用途。可见性按之前的决策选私有或公开初始化选项按需勾选。填完点创建仓库就建好了。随后GitCode会跳到仓库主页页面上会显示仓库地址一般有两种格式HTTPS开头的是https://gitcode.com/用户名/仓库名.gitSSH开头的是gitgitcode.com:用户名/仓库名.git。这两行地址等会儿都有用先记下来。建仓成功后那个自动跳转的页面其实就是给你下一步操作引路的。页面上通常会按已有本地项目和全新项目两种情况分别给出命令直接照着执行就行。我建议新手先别急着复制运行把下面两种路径的原理看明白再动手。3.2 方式一克隆空仓库把本地文件复制进去如果你的本地还没有一个整齐的项目结构只是想快速把一批文件传到GitCode上最省事的方式是先克隆空仓库再往里面填充文件。git clone https://gitcode.com/用户名/仓库名.git cd 仓库名 # 把要上传的文件复制到这个目录里 git add . git commit -m initial commit git push克隆的好处是远端仓库的README、.gitignore、分支结构都已经同步到本地了你不必关心仓库是怎么长出来的只要往目录里放文件再走一遍add、commit、push即可。这条路径很适合建仓时勾选了初始化选项的情况克隆下来本地目录里就已经有那些文件了。第一次push时终端会要求输入GitCode的用户名和密码。密码输入时终端不回显这是正常现象不是键盘坏了吞吞吐吐地输入后回车就行。这一步输入的密码系统可能弹出保存凭据的窗口很多忘记密码的麻烦就是从这里埋下的。别急着点保存先看看第4章再决定。3.3 方式二本地已有项目目录先git init再关联远端这是更常见的情况代码早就写好了目录里有一堆文件现在想把这个目录变成仓库传上去。这时候不需要克隆直接在项目根目录执行git init git add . git commit -m first commit git remote add origin https://gitcode.com/用户名/仓库名.git git branch -M main git push -u origin main逐条解释一下这些命令在干什么。git init是在当前目录生成一个.git子目录从这一刻起这个目录被Git接管。git add .把所有文件加入暂存区这里的点代表当前目录全部内容如果只想传部分文件可以改成具体路径。git commit生成本地第一个历史版本-m后面是提交说明。git remote add origin这一行是让本地仓库记住远端仓库的地址。origin是约定俗成的别名你也可以叫别的名字但所有人都会用origin没必要特立独行。git branch -M main把当前分支名强制改成main与远端默认分支对齐。最后git push -u origin main把本地main分支推送到远端-u参数会记录这次关联关系以后直接输git push就能推不用再写一长串参数。如果你在建仓时勾了README而本地仓库是从零提交的直接push会因为远端有README的提交记录而本地没有提示远端有本地不存在的提交。这种情况最简单的处理办法是先合并再推git pull origin main --rebase git push -u origin main这个话题几乎每周都有人问碰上一次就记住链路了。3.4 第一次push时的认证细节密码到底是谁在验证第一次push输入的用户名和密码验证的是GitCode账号。但HTTP方式下大部分终端软件会把验证过的凭据交给系统凭据管理器保存Windows下对应的是Windows凭据管理器macOS下是钥匙串。这本身是方便功能问题在于当你在网页端改过密码之后凭据管理器里存的还是旧密码于是每次push都被服务端拒绝弹出login failed。所以忘记密码要拆成两层看第一层是GitCode账号本身密码可以在网页端找回第二层是本地系统保存的旧凭据需要在系统层面清理掉。这两件事必须分开处理否则就会陷入我明明在网页端改了密码本地还是推不上去的死循环。这个链条我在下一章完整拆开讲。4. 忘记密码的正确姿势网页重置、本地清凭据、SSH一劳永逸4.1 网页端找回密码能收到验证邮件就很简单如果忘掉的是GitCode账号本身的密码直接在登录页点忘记密码输入注册邮箱系统会发送重置邮件点邮件里的链接设置新密码就行。这个流程和绝大多数网站没有区别难点只在你还能不能进到那个邮箱。如果连注册邮箱都想不起来了就得回忆一下当初是用手机号注册还是邮箱注册。GitCode支持手机号登录的话直接用验证码也可以。搜索一下自己邮箱里有没有GitCode相关的注册确认信这是找回账号最有效的线索。4.2 本地login failed问题多半出在Windows凭据管理器重头戏来了。你在网页端把密码重置好了回到终端重新git push结果还是login failed原因十有八九是本地系统保存着旧凭据。Git在push时优先使用凭据管理器里的记录去请求服务端服务端校验失败于是报错。Windows下清理路径是控制面板 - 用户账户 - 凭据管理器 - Windows凭据。在列表里找到与GitCode相关的条目可能是你的用户名也可能是https://gitcode.com这样的地址删除它回到终端再执行git push这次系统会重新弹出登录窗口输入新密码就能通过。也可以用命令行方式删除cmdkey /list | findstr gitcode cmdkey /delete:目标名称对大多数新手来说图形界面点删除更直观不容易误删其他凭据。删除之后如果还是报login failed再检查两件事一是密码里是不是含有特殊字符终端是否发生了转义二是输入时是不是末尾多按了空格。这类低级错误我帮人排查时见过不止一次。4.3 治本方案配置SSH免密从此告别密码如果觉得忘记密码、清理凭据这个循环太折腾强烈建议改用SSH密钥认证。SSH方式不依赖账号密码而是用一对密钥文件私钥留在本机公钥放到GitCode后台。push时Git用私钥签名服务端用公钥验签认证通过全程不用输入密码。生成密钥的命令ssh-keygen -t ed25519 -C 你的备注信息执行后一路回车即可默认生成的密钥对存放在用户目录的.ssh文件夹里。然后查看公钥内容cat ~/.ssh/id_ed25519.pub把那一串以ssh-ed25519开头的文本完整复制去GitCode的设置 - SSH公钥页面粘贴保存。公钥名称随便起个容易认的比如公司电脑、我的笔记本。然后把本地仓库的远端地址从HTTPS换成SSHgit remote -v # 如果显示的是https://开头执行下面这条 git remote set-url origin gitgitcode.com:用户名/仓库名.git git push这次push不会再弹密码框。验证密钥是否生效可以执行ssh -T gitgitcode.com成功后会返回欢迎信息失败则提示权限被拒绝。配置一次永久生效彻底跳出密码循环。4.4 如果不想配SSH用个人访问令牌替代密码也行有些人不习惯密钥方式那就在HTTPS协议下用个人访问令牌Personal Access Token替代密码。到GitCode的设置 - 访问令牌页面生成一个Token起个名字、选择需要的权限、设置有效期。生成后它只展示一次要立刻复制保存。之后不管是IDE还是git push提示输入密码时把Token粘贴进去就行。Token相当于一个可控制的临时密码到期可以重新签发即使不小心泄露也不会直接暴露主账号密码。我的评价是它比记住原始密码省心因为原始密码你总会忘Token可以在后台随时重新生成不用走找回密码流程。4.5 换电脑场景SSH密钥怎么迁移如果平时家里和公司各一台电脑密码又容易忘最好的做法是让每台电脑各自生成一套SSH密钥把各自的公钥都加到GitCode后台。别从一台电脑直接把私钥文件拷到另一台虽然技术上可行但私钥一旦泄露就要全部重来。我自己还有个习惯生成密钥时用带标识的文件名比如id_ed25519_work与默认的id_ed25519区分开多机器混用的时候不容易搞混。如果有人问你为什么换了电脑配了SSH还是推不了先让他跑一下ssh -T gitgitcode.com大概率是公钥没添加或者添加的其实是另一台电脑的公钥。5. 建仓和上传路上我踩过的五个坑报错原文和修复思路5.1 fatal: not a git repository (or any of the parent directories): .git这条报错几乎每个Git新手都会遇到。字面意思是当前目录不是Git仓库。常见原因就一个命令执行的位置不对。比如在一个从来没有git init过的普通文件夹里执行git add就会收到这个提示。解决办法也很直白cd回到项目根目录确认那里有.git目录再执行操作。如果你压根没执行过git init就在根目录先初始化。还有一种场景我在帮人排查时碰到过在完全无关的目录里执行git push它也会报这个错。这时候先git remote -v看看当前目录到底关联了什么远端别在错误的目录里瞎推。5.2 ssh: Permission denied (publickey) / Host key verification failed配置SSH之后最容易踩的两个坑。Permission denied (publickey)说明服务端没有找到匹配的公钥。优先检查三处公钥是否已经添加到GitCode后台复制公钥时有没有漏掉末尾的备注信息粘贴时是否混入了额外的空格或换行。我见过最多的就是复制公钥时把行首行尾的空格一起粘上去了密钥对不上自然被拒。Host key verification failed出现在第一次SSH连接GitCode的时候。终端在问你是否信任这台主机输入yes回车就行。如果输成y或者直接按回车SSH会当成拒绝报同样的错。这个提示本质是防止中间人攻击的安全机制确认域名是gitcode.com后放心信任。5.3 git commit --amendpush之后别再用了amend这个命令的作用是修改最近一次提交的信息很多人在push前用它修正first commit这样的不正规提交说明这是完全正确的用法。但如果你在push之后再执行amend麻烦就来了amend会生成一个全新的提交节点而远端旧提交还挂在原来的位置上两边历史分叉。下次pushGit会拒绝推送提示当前分支落后于远端。有人会教你用git push --force-with-lease强制覆盖。对共享仓库来说force push很容易把别人的提交覆盖掉我不推荐新手这么干。个人建议push之前随便amendpush之后别碰它。如果确实改了个人仓库的提交信息需要强推也要先确认这个仓库没有别人在协作。5.4 本地master和远端main对不上push被拒绝在配置init.defaultBranch之前本地git init出来的默认分支叫master而GitCode新建仓库的默认分支一般是main。两边分支名不一致push时会提示! [rejected]和failed to push some refs。解法在命令里其实已经给出来了git branch -M main把本地分支改名后再push。GitCode建仓成功后给的提示命令里通常就有这一行问题是很多教程互相抄漏了于是反复出现为什么我没做任何修改却推不上去的提问。分支这套概念以后还会在git merge、git branch -a这些命令里反复遇到现阶段只要记住main是远端主分支本地分支名必须和它一致才能推送。5.5 login failed. check api token or gitlab version最后说一个很有代表性的报错。如果你在VS Code等IDE里用GitLab扩展连接GitCode可能会看到login failed. check api token or gitlab version。GitCode的界面和API兼容GitLab但扩展默认按GitLab官方版本来连接版本对不上、或者没有配置API Token时就会报错。处理方式两种第一在扩展设置里填上API Token到GitCode后台生成一个个人访问令牌填进去GitLab版本一栏填GitCode支持的对应版本一般以GitCode帮助文档为准第二干脆不用GitLab扩展直接用VS Code内置的源代码管理走HTTPS或SSH反而少一层配置问题。对日常commit、push、pull来说内置功能已经足够了没必要为了用扩展而额外折腾认证。说实话GitCode建仓和上传本地文件本身不算多高级的操作但密码忘了、凭据不对、分支名不匹配这些小问题恰恰是最容易劝退新手的。我个人的体会是建仓上传成功之后趁热打铁把SSH或者Token配好成本不超过五分钟却能省掉未来无数次忘记密码的折腾。如果哪天你连网页端都登不进去别急着重装系统、重装Git先确认网络环境正常、浏览器能打开GitCode官网。很多认证问题不在本地而在环境本身。把这些链路理清了GitCode对你来说就只是个很顺手的工具。