好的,将 IntelliJ IDEA 中的项目推送到 Gitee(码云)仓库是一个非常常见的操作。下面是详细的步骤,分为两种情况:1. 项目还未与任何 Git 仓库关联2. 项目已经关联了其他 Git 远程仓库(如 GitHub)


准备工作

  1. 安装 Git:确保你的电脑上已经安装了 Git。可以在终端(Terminal)或命令行中输入 git --version 来检查。如果没有,请前往 Git 官网下载安装。
  2. 在 Gitee 上创建仓库:你已经完成了这一步。记下你的仓库的 HTTPS 或 SSH 地址(例如:https://gitee.com/your_username/your_repo_name.git)。
  3. 在 IDEA 中配置 Git:打开 IDEA,进入 File -> Settings -> Version Control -> Git,在 Path to Git executable 中指定你的 git.exe 的路径,确保 IDEA 能正确识别。

情况一:项目是全新的,还未与 Git 关联

这是最常见的情况,步骤也最完整。

步骤 1:在 IDEA 中初始化本地 Git 仓库
  1. 打开你的项目。
  2. 在顶部菜单栏,选择 VCS -> Import into Version Control -> Create Git Repository...
    • 注意:新版本的 IDEA 可能会直接提示你“Add Root”,或者这个菜单路径可能略有不同。如果找不到,可以尝试右键点击项目根目录,选择 Git -> Create Repository...
  3. 在弹出的对话框中,确保选择的是你当前项目的根目录,然后点击 OK。这时你的项目文件会变成红色(Unversioned),表示它们已被 Git 识别但还未被跟踪。
步骤 2:将文件添加到暂存区 (Stage)
  1. 在 IDEA 中,右键点击项目根目录。
  2. 选择 Git -> Add
    • 或者,你也可以在底部的 Git 面板中(通常在主窗口下方),选中所有文件,然后点击 +Add 按钮。
  3. 添加后,文件会变成绿色(Added),表示它们已进入暂存区,准备被提交。
步骤 3:执行第一次提交 (Commit)
  1. 右键点击项目根目录,选择 Git -> Commit Directory...,或者直接点击工具栏上的 Commit 按钮 (一个绿色的对勾 ✔️)。
  2. 在弹出的提交窗口中,输入有意义的提交信息(Commit Message),例如 “Initial commit”。
  3. 确认要提交的文件都已勾选,然后点击 Commit 按钮。
步骤 4:添加 Gitee 远程仓库地址并推送

这是最关键的一步,将本地仓库与远程的 Gitee 仓库关联起来。

  1. 右键点击项目根目录,选择 Git -> Manage Remotes...
  2. 在弹出的窗口中,点击 + 号。
  3. Name 一栏,通常默认叫 origin(这是远程仓库的常见别名)。
  4. URL 一栏,粘贴你之前在 Gitee 上创建好的仓库的地址
    • HTTPS: https://gitee.com/your_username/your_repo_name.git
    • SSH: git@gitee.com:your_username/your_repo_name.git
    • 推荐使用 HTTPS,最简单,但每次推送可能需要输入账号密码。如果使用 SSH,需要先配置 SSH 公钥,但之后更便捷安全。
  5. 点击 OK 保存,然后再点击 OK 关闭窗口。
  6. 开始推送:右键点击项目根目录,选择 Git -> Push...,或者点击工具栏上的 Push 按钮 (一个蓝色的箭头 ↑)。
  7. 在弹出的窗口中,确保远程仓库是 origin,分支是 mainmaster(取决于你的设置)。
  8. 点击 Push 按钮。
  9. 如果是第一次使用 HTTPS 连接,IDEA 会弹窗让你输入 Gitee 的用户名和密码(或个人访问令牌)
    • 注意:从 2021 年 8 月起,GitHub 和 Gitee 等平台都不再支持直接使用账户密码进行命令行操作。你需要使用个人访问令牌(Personal Access Token, PAT) 作为密码。
    • 前往 Gitee 的 设置 -> 私人令牌,生成一个新的令牌,并赋予所有权限。在 IDEA 要求输入密码时,将这个令牌粘贴进去

操作完成后,去你的 Gitee 仓库页面刷新一下,就能看到项目文件已经全部上传了。


情况二:项目已经关联了其他 Git 远程仓库(例如 GitHub),想改为推送到 Gitee

如果你的项目是从 GitHub 克隆下来的,或者原本就关联了别的远程仓库,你想在 Gitee 上做一个备份或镜像。

步骤 1:修改远程仓库地址
  1. 打开项目,它应该已经是一个 Git 仓库了。
  2. 右键点击项目根目录,选择 Git -> Manage Remotes...
  3. 你会看到现有的远程仓库(通常叫 origin)。你可以:
    • 直接修改:选中 origin,点击铅笔图标,将 URL 修改为你的 Gitee 仓库地址。
    • 添加一个新的:点击 + 号,添加一个名为 gitee 的远程仓库,URL 填你的 Gitee 地址。这样做的好处是你可以同时保留两个远程仓库,分别执行推送(git push origin 推送到原来的,git push gitee 推送到 Gitee)。
步骤 2:推送到 Gitee
  1. 右键点击项目根目录,选择 Git -> Push...
  2. 如果上一步你修改了 origin,那么直接点击 Push 即可。
  3. 如果上一步你新添加了一个叫 gitee 的远程,那么你需要:
    • 点击推送窗口顶部的下拉框,将远程仓库从 origin 改为 gitee
    • 然后点击 Push

同样,首次推送需要认证,请使用你的 Gitee 用户名和个人访问令牌。


总结与要点

步骤 关键操作 说明
1. 初始化 VCS -> Create Git Repository 在项目根目录创建本地 .git 文件夹
2. 添加文件 右键 -> Git -> Add 将文件从“未跟踪”变为“已暂存”
3. 首次提交 点击 Commit 按钮 (✔️) 将暂存区的文件提交到本地仓库,形成一次历史记录
4. 添加远程 右键 -> Git -> Manage Remotes 添加 Gitee 仓库的 URL,别名常用 origin
5. 推送 点击 Push 按钮 (↑) 将本地仓库的提交推送到远程 Gitee 仓库
认证 使用个人访问令牌 (PAT) 非常重要! 密码栏不要输入登录密码,要输入在 Gitee 后台生成的令牌

按照这个流程,你一定能成功将项目推送到 Gitee。如果遇到问题,请重点检查远程仓库地址是否正确以及认证是否使用了令牌而非密码

Logo

腾讯云面向开发者汇聚海量精品云计算使用和开发经验,营造开放的云计算技术生态圈。

更多推荐