Master Gitee: From Registration to IDE Integration and Project Sync

1. Introduction

GitHub servers are overseas, which can cause poor performance or login failures for users with bad network conditions. Gitee, a domestic Git-based code hosting platform, offers a similar experience with a Chinese interface, making it an ideal alternative.

10.2 Register a Gitee Account

Click the "Register" button on the Gitee homepage to open the registration page.

Enter the required information, receive a verification code via email, and complete registration.

After verification, you are automatically logged in to your Gitee personal homepage.

10.3 Create a Remote Repository

Click "New Repository".

Set the repository name and type, then click "Create". Note: initially select a private repository, then change it to public in settings.

After creation, you can obtain the HTTPS and SSH URLs; HTTPS is recommended due to Gitee's domestic servers.

10.4 IDEA Integration with Gitee

10.4.1 Install the Gitee Plugin

In IDEA, go to File → Settings → Version Control ; the Gitee functionality is not present by default.

Open Plugins → Marketplace , search for "gitee", and install the plugin.

Accept the third‑party plugin installation and restart IDEA.

After restart, Gitee features appear under Version Control .

10.4.2 Log in to Gitee

In Version Control → Gitee , click the "+" button and enter your Gitee credentials.

10.4.3 Share Project to Gitee

Open Share Dialog

Select VCS → Import into Version Control → Share Project on Gitee .

Set Remote Repository Properties

Specify the repository name (default matches the project name) and a local alias (default "gitee"). Choose public or private as needed.

Note: The example account lacks a bound phone, so only private repositories can be created.

Share Operation Result

Click "Share" to create the remote repository and push the project; the repository appears on Gitee.

10.4.4 Push Updates to Remote

Local Changes

Modified files turn blue in the IDE.

Commit to Local Repository

Enter a commit message and click "Commit".

After committing, file colors revert to black and the commit appears in the Version Control → Log view.

Push (Method 1)

Right‑click the project, choose Git → Repository → Push to open the push dialog.

Note: Subsequent steps follow Method 2.

Push (Method 2)

Or use VCS → Git → Push to open the same dialog.

The remote alias is automatically selected.

Push Result

After clicking "Push", the updates appear in the remote repository.

10.4.5 Pull Updates to Local

Always ensure your local version is up‑to‑date before pushing; otherwise pull the latest changes first.

Pull (Method 1)

Right‑click the project and select Git → Repository → Pull .

Note: Subsequent steps follow Method 2.

Pull (Method 2)

Use VCS → Git → Pull to open the pull dialog, choose the remote URL, and pull.

After pulling, the remote updates are merged into the local repository.

Note: If automatic merge fails, resolve conflicts manually.

10.4.6 Clone Remote Repository to Local

Delete Local Repository

Since the project is backed up on Gitee, you can delete the local copy and later clone it again.

Clone via IDEA

In IDEA's welcome screen, select Check out from Version Control → Git .

Enter the remote repository URL, test the connection, and click "Clone".

After cloning, IDEA prompts to open the project, and the code and commit history are available locally.

Note: If you encounter "Error:java: unsupported release version 5", refer to the relevant solution.

10.5 Gitee Copy GitHub Project

10.5.1 Import via Remote URL

Gitee provides a direct "Copy GitHub Project" feature for migration.

Paste the GitHub HTTPS URL and click "Import" to copy the project to Gitee.

Note: When creating a new Gitee repository, you must initially select a private type and later change it to public in settings.

The GitHub project is now successfully copied to Gitee.

10.5.2 Force Sync Feature

When the GitHub repository updates, click the refresh button next to the Gitee repository name to synchronize changes.

The sync dialog warns that the Gitee repository will be overwritten.

After confirming, the forced sync completes successfully.