Renesas E2 Studio项目Git推送及跨系统拉取克隆求助

一、本地项目初始化Git仓库 #

• 打开E2 Studio，找到项目根目录，右键选Show In > Terminal（或者直接在系统终端进入项目根目录）
• 执行初始化命令：git init
• 创建.gitignore文件，添加以下内容过滤E2 Studio冗余文件，避免提交不必要的内容：

  # E2 Studio相关文件
  .metadata/
  .cproject
  .project
  .settings/
  Debug/
  Release/
  *.o
  *.elf
  *.map
  

• 把所有文件加入暂存区：git add .
• 提交初始版本：git commit -m "Initial commit: E2 Studio project base"

二、关联远程Git服务器仓库 #

• 先在Git服务器上创建空仓库（别勾选初始化README、LICENSE这类选项）
• 在终端执行关联命令，替换<remote-url>为你的远程仓库地址：git remote add origin <remote-url>
• 验证关联是否成功：git remote -v

三、推送本地项目至远程仓库 #

• 首次推送执行：git push -u origin main（如果远程默认分支是master，就替换成master）
• 要是碰到权限问题，检查本地Git配置的用户名和邮箱是否正确：

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

  同时确认Git服务器账号有该仓库的读写权限

四、跨系统拉取克隆项目 #

• 在目标系统终端执行克隆命令：git clone <remote-url>
• 克隆完成后，打开E2 Studio，选File > Import > General > Existing Projects into Workspace，选中克隆下来的项目目录导入即可

常见问题排查 #

• 推送失败提示"refusing to merge unrelated histories"：先执行git pull origin main --allow-unrelated-histories，再重新推送
• E2 Studio导入项目后编译报错：检查项目工具链配置是否和本地环境匹配，重新指定编译器路径
• 权限被拒绝：确认Git服务器的SSH密钥/账号密码配置正确，远程仓库已开放读写权限

内容的提问来源于stack exchange，提问作者Jefferson John