关于如何将项目上传至Github（大于100MB的文件）

系统：Ubuntu 20.04

事先准备：安装GIT LFS

sudo apt update sudo apt install git-lfs

———————————————————————————————————————————

0.新建repository

这一步可以参考：https://blog.csdn.net/LSG_Down/article/details/148142873?ops_request_misc=&request_id=&biz_id=102&utm_term=%E4%B8%8A%E4%BC%A0Github%E9%A1%B9%E7%9B%AE%20Ubuntu&utm_medium=distribute.pc_search_result.none-task-blog-2~all~sobaiduweb~default-2-148142873.142^v102^pc_search_result_base2&spm=1018.2226.3001.4187

1.创建.gitignore文件

创建.gitignore文件来排除不需要上传的文件，文件具体内容可以参考如下内容。

# ROS 构建文件 build/ devel/ install/ .catkin_workspace *.pyc __pycache__/ # IDE 配置文件 .vscode/ .idea/ *.swp *.swo *~ # 其他 *.log

2.Git 初始化

cd mybot_ws && git init git status

运行结果如图

3.添加相关文件到 Git

这里笔者添加的是.gitignore，src和README.md。

cd /home/sparks/mybot_ws && git add .gitignore src/ README.md

PS：如果你的项目里有内嵌的 Git 仓库，比如这里笔者的项目就内嵌了一个 realsense-ros 库，那么就需要处理这个子模块。

先移除

cd /home/sparks/mybot_ws && git rm --cached -rf src/realsense-ros

然后检查其远程仓库地址

cd /home/sparks/mybot_ws/src/realsense-ros && git remote -v

输出结果如下

然后将其添加为子模块。

cd /home/sparks/mybot_ws && git submodule add https://github.com/IntelRealSense/realsense-ros.git src/realsense-ros

4.配置 Git 信息

cd /home/sparks/mybot_ws && git config user.name "user.name"

cd /home/sparks/mybot_ws && git config user.email "user.email"

5.创建提交

cd /home/sparks/mybot_ws && git commit -m "Initial commit: Add ROS workspace src directory with SLAM, navigation, and detection packages"

6.添加 Github 远程仓库并推送

注意，这里的httys地址要换成自己的。

cd /home/sparks/mybot_ws && git remote add origin https://github.com/zhaofang0604/Tyran-Robot-in-our-lab.git

7.使用 HTTPS 方式和 Personal Access Token 来推送代码

获取 Personal Access Token 的具体方法

1. 访问：https://github.com/settings/tokens
2. 点击 "Generate new token" → "Generate new token (classic)"
3. 设置 Token 名称（如 "Lab Computer Upload"）
4. 选择过期时间
5. 勾选以下权限：
   • ✅repo（完整的仓库控制）
     • repo:status
     • repo_deployment
     • public_repo
     • repo:invite
     • security_events
6. 点击 "Generate token"
7. 立即复制新生成的 token

这里必须要勾选 repo 权限。

然后更新 token 凭证，这里记得把具体信息换成自己的。

echo "https://user.name:Token@github.com" > ~/.git-credentials && chmod 600 ~/.git-credentials

最后，进行推送即可，这里是推送到 master 分支。

cd /home/sparks/mybot_ws && git push -u origin master

——————————————————————————————————————————————

补充：如果想将文件上传至新分支的话，需要在GIT初始化后先运行如下代码创建新分支，这里笔者创建的新分支为 feature-update。

git checkout -b feature-update

创建新分支之后，接着按流程走即可。注意，最后推送时也要将运行代码最后的 master 换成新分支的名称。

cd /home/sparks/mybot_ws && git push -u origin feature-update