本地项目推送到GitCode完整流程（避坑指南）

最近在将本地Axure项目推送到GitCode时遇到了不少问题，从认证失败到文件大小限制，踩了一圈坑后终于成功推送。现将完整流程整理出来，希望能帮到遇到类似问题的朋友。

一、准备工作

1. 必要环境

   • 安装Git（官网下载对应系统版本）
   • 注册并登录GitCode账号
   • 本地项目文件夹（本文以Axure项目为例）

2. 创建访问令牌

   • 登录GitCode后，进入个人设置 → 访问令牌
   • 新建令牌，建议勾选以下权限：
     • 项目（repo）：读写权限
     • 仓库（Repository）：读写权限
   • 生成后立即保存令牌（只显示一次）

3. 在GitCode创建仓库

   • 点击右上角"+"号 → 新建项目
   • 填写仓库名称（建议用英文，避免中文编码问题）
   • 设置仓库可见性（公开/私有）
   • 点击"创建项目"，记住仓库的HTTPS地址

二、本地操作步骤

1. 初始化本地仓库

打开命令提示符（CMD）或Git Bash，进入项目目录：

# 进入项目文件夹
cd D:\download\axure

# 初始化Git仓库
git init

2. 配置大文件处理（关键步骤）

如果项目包含超过100MB的大文件（如Axure安装包），必须使用Git LFS：

# 安装Git LFS
git lfs install

# 跟踪大文件（以exe为例，可根据需要修改）
git lfs track "*.exe"

# 将LFS配置文件添加到暂存区
git add .gitattributes
git commit -m "配置LFS跟踪大文件"

3. 添加并提交项目文件

# 添加所有文件到暂存区
git add .

# 提交到本地仓库
git commit -m "首次提交：包含Axure相关文件"

4. 关联远程仓库

# 关联GitCode仓库（替换为你的仓库地址）
git remote add origin https://gitcode.com/你的用户名/你的仓库名.git

5. 解决分支名称问题

Git默认分支可能是master，而远程可能是main，需要统一：

# 重命名本地分支为main
git branch -M main

6. 推送至远程仓库

# 首次推送并关联分支
git push -u origin main

推送时会提示输入账号密码：

• 用户名：你的GitCode账号名
• 密码：之前创建的访问令牌（不是登录密码）

三、常见问题解决

1. 认证失败（HTTP Basic: Access denied）

   • 检查令牌是否正确，权限是否足够
   • 重新生成令牌并更新远程地址：

   git remote set-url origin https://用户名:新令牌@gitcode.com/用户名/仓库名.git
   

2. 文件大小超限（pre-receive hook declined）

   • 确保大文件已被LFS跟踪（执行git lfs status检查）
   • 若已提交过大文件，需清理历史记录后重新提交

3. 分支不匹配（src refspec main does not match any）

   • 执行git branch查看本地分支名
   • 用git branch -M main重命名为main分支

4. 中文文件名/路径问题

   • 尽量使用英文命名
   • 必要时用英文引号包裹命令中的路径

四、总结

将本地项目推送到GitCode的核心步骤是：初始化仓库 → 配置LFS → 提交文件 → 关联远程 → 推送分支。其中，大文件处理和分支名称匹配是最容易出问题的地方，按照本文步骤操作可以有效避坑。

如果遇到其他错误，建议仔细阅读错误提示，通常会明确指出问题所在。祝大家代码推送顺利！