【C 语言】初识 Git：用 Git 上传项目到远端

这篇文章只完成一件事：在 Windows、Linux 或 macOS 上，把电脑里的 C 语言项目上传到 GitHub 或 Gitee，修改代码后再同步一次。

!把 C 语言项目上传到 GitHub 的路线图

一、安装工具

Windows

安装 Git for Windows。安装完成后，在文件夹空白处右键，如果能看到 Git Bash Here，说明基本安装成功。

Windows 还可以安装 TortoiseGit，用右键菜单完成 Add、Commit 和 Push；后文会同时给出命令行写法。

macOS

打开“终端”，执行：

xcode-select --install

按提示安装 Apple 的命令行工具，其中包含 Git。安装完成后执行 git --version 检查。如果你已经使用 Homebrew，也可以执行 brew install git。

Linux

在终端中按发行版安装 Git。Ubuntu 或 Debian 使用：

sudo apt update
sudo apt install git

Fedora 使用：

sudo dnf install git

安装完成后执行 git --version 检查。

TortoiseGit（仅 Windows）

TortoiseGit 为 Git 提供右键菜单和图形界面。下载地址：

<https://tortoisegit.org/download/>

先安装 Git for Windows，再安装 TortoiseGit。安装 TortoiseGit 时，如果要求指定 git.exe，选择 Git for Windows 的默认安装路径即可。安装完成后重启文件资源管理器或电脑。

设置提交者信息

Windows 可以打开任意文件夹的右键菜单：

TortoiseGit → Settings

在 Git 配置页面填写姓名和邮箱：

Name：你的名字或 GitHub、Gitee 用户名
Email：GitHub 或 Gitee 账号绑定的邮箱

这两项信息会写入提交记录，不是 GitHub 或 Gitee 的登录密码。

Linux 和 macOS 可以在终端执行同样的配置：

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

三种系统的 Git 提交格式相同，区别主要是安装方式、文件路径和操作界面。

二、在 GitHub 或 Gitee 创建仓库

打开 GitHub 或 Gitee，注册并登录账号，完成邮箱验证。

在 GitHub 中点击右上角的 +，选择 New repository；在 Gitee 中点击右上角的 +，选择新建仓库。仓库名称可以写成：

hello-git

练习时可以选择 Public。第一次操作可以不勾选自动创建 README、.gitignore 和许可证，先用一个空仓库完成克隆和上传。

点击创建仓库，然后点击 Code，选择 HTTPS，复制仓库地址。地址通常是：

<https://github.com/用户名/hello-git.git>
<https://gitee.com/用户名/hello-git.git>

三、把 GitHub 或 Gitee 仓库克隆到电脑

Clone 是把 GitHub 或 Gitee 上的仓库下载到本地。

Windows 假设项目准备放在 D:\Code。打开这个文件夹，在空白处右键，选择 Git Clone，填写：

URL：
<https://github.com/用户名/hello-git.git>

或：
<https://gitee.com/用户名/hello-git.git>

Directory：
D:\Code\hello-git

点击 OK，等待克隆完成。之后得到的 D:\Code\hello-git 就是本地 Git 仓库。

Linux 和 macOS 使用终端克隆。先进入希望保存项目的目录，再执行：

cd ~/Code
git clone <https://github.com/用户名/hello-git.git>
# 或：
git clone <https://gitee.com/用户名/hello-git.git>

克隆完成后，hello-git 目录就是本地 Git 仓库。Linux 和 macOS 使用 /Users/用户名/... 或 /home/用户名/... 这样的路径，不使用 Windows 的 D:\Code 写法。

四、把 C 代码放入仓库

在 Windows 的 D:\Code\hello-git，或 Linux/macOS 的 ~/Code/hello-git 中新建 main.c：

#include <stdio.h>

int main(void)
{
    printf("Hello, Git!\n");
    return 0;
}

也可以用 Visual Studio 等工具，在这个目录中创建 C 语言工程；已有项目则直接复制到这里。

设置 .gitignore

.gitignore 是 Git 的忽略规则文件。它只能阻止“还没有被 Git 跟踪”的文件进入下一次提交，不能删除已经提交到仓库的文件。

编译产生的 .exe、.obj、Debug 等文件通常不需要上传。在仓库根目录创建 .gitignore。文件名必须是 .gitignore，不要变成 .gitignore.txt：

*.exe
*.obj
*.o
.vs/
Debug/
Release/

常见写法可以这样理解：

# 忽略所有目录下的 .exe 文件
*.exe
# 忽略名为 Debug 的目录及其内容
Debug/
# 只忽略仓库根目录下的 temp 目录
/temp/
# 忽略名为 config.local 的本地配置文件
config.local
# 例外：不要忽略 keep.exe
!keep.exe

规则从上到下匹配，后面的规则可以覆盖前面的规则。个人电脑专用的临时规则可以放在 Git 的全局忽略文件中，但项目成员都应该遵守的规则要写进项目根目录的 .gitignore，并把 .gitignore 本身提交到 GitHub 或 Gitee。

检查忽略规则是否生效

在仓库目录打开 Git Bash、PowerShell 或 Linux/macOS 终端，执行：

git check-ignore -v Debug/main.obj

如果规则生效，Git 会显示是哪一行 .gitignore 忽略了这个文件。也可以查看当前仓库的状态：

git status

被忽略的临时文件不再出现在待提交列表中，说明规则已经生效。

已经提交过的文件怎么办

如果 .exe 或 Debug/ 已经被提交，后来才补写 .gitignore，它们仍会继续出现在 Git 的变更列表中。这时要先从 Git 的跟踪记录中移除，再提交一次：

git rm --cached -r Debug
git commit -m "停止跟踪编译目录"

• -cached 只移除 Git 的跟踪，不会删除电脑上的 Debug 文件夹。Windows 下也可以在 TortoiseGit 的提交窗口中对这些文件执行“删除并保留本地文件”一类的操作，具体名称可能随版本略有不同。

五、第一次上传代码

!Add、Commit、Push 的区别

1. Add：将文件加入暂存区

Windows 用户在 hello-git 文件夹中右键，选择：

TortoiseGit → Add

勾选 main.c 和 .gitignore 等需要提交的文件，点击 OK。这一步只是告诉 Git 哪些文件要参加下一次提交，代码还没有上传到 GitHub 或 Gitee。

2. Commit：保存本地版本

Windows 用户在仓库目录中右键，选择 TortoiseGit → Commit。有些版本会显示为 Git Commit → main 或 Git Commit → master，这是分支名称的不同。

检查文件，填写提交说明：

完成第一个 C 程序

点击 Commit。这一步只在本地保存版本，GitHub 或 Gitee 页面还不会变化。

3. Push：上传到 GitHub 或 Gitee

Windows 用户右键选择：

TortoiseGit → Push

使用默认设置确认推送。第一次推送需要进行 GitHub 或 Gitee 身份验证。GitHub 不支持在 HTTPS Git 操作中直接使用账号密码；Gitee 也建议使用 Personal Access Token 或 SSH。按页面提示完成授权即可。

推送完成后刷新 GitHub 或 Gitee 仓库页面，就能看到 main.c、.gitignore 和提交说明。

Linux 和 macOS 没有 TortoiseGit，可以直接在仓库目录的终端执行同样的流程：

git add main.c .gitignore
git commit -m "完成第一个 C 程序"
git push origin main

如果仓库使用的默认分支不是 main，先执行 git branch --show-current 查看当前分支，再把命令中的 main 换成实际分支名。Windows 用户也可以在 Git Bash 中使用这组命令。

六、修改代码后再次上传

把 main.c 改成：

#include <stdio.h>

int main(void)
{
    printf("Hello, Git and GitHub or Gitee!\n");
    return 0;
}

保存后再次执行：

Add（只有新增文件时需要）→ Commit → Push

已经被 Git 跟踪的 main.c 会直接出现在提交窗口中；使用终端时，直接执行 git add main.c。提交说明可以写：

修改程序输出内容

推送完成后刷新 GitHub 或 Gitee 页面，就能看到新代码和新的提交记录。

七、记住三个操作

Add：选择要提交的文件
Commit：在本地保存版本
Push：上传到 GitHub 或 Gitee

平时的流程就是：

修改代码 → Add 新文件（如有）→ Commit → Push

只执行 Commit 时，版本还在本地；执行 Push 后，远程的 GitHub 或 Gitee 仓库才会收到这个版本。

八、常见问题

右键找不到 TortoiseGit

检查 Git for Windows 和 TortoiseGit 是否都安装完成。Windows 11 中可以先点击“显示更多选项”。

Git 找不到代码

代码必须放在仓库目录或它的子目录中。例如仓库是 D:\Code\hello-git，代码就不能放在旁边的 D:\MyProject。

GitHub 或 Gitee 页面没有更新

Commit 只保存本地版本，还需要执行 TortoiseGit → Push，然后刷新 GitHub 或 Gitee 网页。

上传了大量编译文件

检查 .gitignore 是否位于仓库根目录，并确认文件名不是 .gitignore.txt。

九、完成检查

• 能创建 GitHub 或 Gitee 仓库，并在 Windows、Linux 或 macOS 上完成克隆。
• 能把 C 语言项目放到正确目录。
• 能完成 Add、Commit、Push。
• 修改代码后能再次提交并推送。
• 能在 GitHub 或 Gitee 中查看代码和提交记录。