> 技术文档 > 如何把本地项目代码传到gitee仓库中_怎么将本地项目上传到git上

如何把本地项目代码传到gitee仓库中_怎么将本地项目上传到git上

将本地项目代码上传到Gitee仓库的完整流程如下,结合最佳实践和常见问题解决方案整理而成:


🔧 一、准备工作

  1. 注册Gitee账号
    访问Gitee官网完成注册,并登录账号。
  2. 安装Git
    从Git官网下载安装包,按默认选项完成安装。安装后验证:
    git --version # 显示版本号即安装成功
  3. 配置Git全局信息
    设置用户名和邮箱(需与Gitee账号一致):
    git config --global user.name \"你的Gitee用户名\"git config --global user.email \"你的Gitee绑定邮箱\"

🛠️ 二、创建Gitee远程仓库

  1. 在Gitee点击 “+” → “新建仓库”
  2. 填写仓库名称(建议英文)、描述,选择公开/私有。
  3. 关键设置
    • 不勾选 “初始化仓库”(避免自动生成README等文件导致冲突);
    • 不添加 .gitignore 或许可证模板。
  4. 点击 “创建”,保存生成的仓库HTTPS/SSH地址(后续需使用)。

💻 三、初始化本地Git仓库

  1. 进入项目根目录,右键打开终端(或Git Bash)。
  2. 执行命令初始化仓库:
    git init # 生成隐藏的.git文件夹
  3. 添加文件到暂存区
    git add . # 添加所有文件(或指定文件路径)
  4. 提交到本地仓库
    git commit -m \"初始提交描述\" # 提交信息需简洁明确

🔗 四、关联远程仓库并推送

  1. 关联远程仓库(替换为你的仓库地址):
    git remote add origin https://gitee.com/你的用户名/仓库名.git
  2. 首次推送代码
    git push -u origin master # -u参数关联分支,后续推送可简写为git push
    • 若提示认证失败,输入Gitee账号密码。
  3. 处理远程非空仓库冲突
    若远程仓库已存在文件(如初始化了README),需先拉取合并:
    git pull origin master --allow-unrelated-histories # 强制合并历史# 解决冲突后重新提交git push -u origin master

⚠️ 五、常见问题与优化

  1. 认证失败

    • 推荐使用SSH免密推送
      ssh-keygen -t rsa -C \"邮箱\" # 生成密钥,默认三次回车cat ~/.ssh/id_rsa.pub # 复制公钥

      在Gitee 设置→SSH公钥 中添加公钥,将远程地址改为SSH格式(如 git@gitee.com:用户名/仓库名.git)。

    • 或使用个人令牌(Token) 替代密码。
  2. 文件过滤
    在项目根目录创建 .gitignore 文件,添加需忽略的文件/文件夹(如 node_modules/, .idea/)。

  3. 分支管理

    • 推送其他分支:git push origin 分支名
    • 删除远程分支:git push origin --delete 分支名

📌 六、验证上传结果

登录Gitee,进入仓库查看代码是否已成功同步。后续更新代码只需重复:

git add .git commit -m \"更新描述\"git push # 已关联分支可省略参数

提示:若操作中频繁遇到冲突或认证问题,建议优先配置SSH密钥,并确保本地与远程分支一致性(通过 git status 检查状态)。

手机铃声库