20260319-编程踩坑总结
在深度学习过程中发现训练代码会有很多个迭代的版本但是发现每次完成一个后发现有很多的版本，像极了项目的word 的版本管理（V1，V2，V2.1.....）无语，所以一定要用起来这种git的项目管理能力。
最近在本地修改一个目标检测项目（Moving-object-detection-DSFNet-main），写了一些代码后想推送到 GitHub，结果遇到了一连串报错。
问题 1：推送时报错src refspec main does not match any
报错信息：
bash
复制
$ git push -u origin main error: src refspec main does not match any error: failed to push some refs to 'https://github.com/rose686/xxx.git'第一反应：以为是远程仓库地址错了，或者分支名拼写错误。
排查过程：
bash
复制
$ git branch # 没有任何输出...这时候有点懵——为什么git branch会一片空白？仓库明明已经git init了，文件也都在。
关键发现：
bash
复制
$ git status On branch main No commits yet Changes to be committed: (use "git rm --cached <file>..." to unstage) new file: .gitignore new file: README.md new file: evaluation.py # ... 还有很多文件恍然大悟：No commits yet！虽然git add .已经把文件放进暂存区了，但还没有做第一次commit。Git 的分支本质上是指向提交的指针，没有提交 = 没有分支 = 无法推送。
解决方案：
bash
复制
git commit -m "Initial commit" git push -u origin main✅成功！远程仓库终于能看到代码了。
问题 2：分支管理混乱（0319exp vs 0319exp1）
推送成功后，我创建了实验分支0319exp想做一些改动测试。结果手滑，又多创建了一个0319exp1。看着 VS Code 状态栏上并列的三个分支名，突然有点焦虑——这算不算把仓库搞乱了？
用图查看分支关系：
bash
复制
$ git log --oneline --graph --all * f646f1d (HEAD -> main, origin/main, 0319exp) Initial commit重要发现：main和0319exp都指向同一个提交f646f1d。原来此时两个分支是完全相同的，它们只是同一个节点的不同标签而已。
清理思路：
如果不需要
0319exp1，可以直接删除：git branch -d 0319exp1如果要开始实验，先
git checkout 0319exp，然后正常修改代码、commit，这样分支才会真正"分叉"
核心收获
Git 的提交是根基
以前以为git init+git add就能推送了，现在明白：没有 commit 的历史，就像没有地基的建筑，push 根本无从谈起。git branch不显示任何内容，正是因为 HEAD 还没指向任何具体的提交。分支只是轻量级的指针
看到main和0319exp同时指向f646f1d时才真正理解：分支不是"复制"代码，只是一个指向提交的引用。创建分支成本极低，可以放心使用。查看历史比盲目操作更重要
git status和git log --oneline --graph --all是排查问题的利器。前者告诉你现在在哪（工作区状态），后者告诉你整个仓库的拓扑结构。
给自己的备忘录
下次新建仓库的标准流程：
bash
复制
git init git add . git commit -m "Initial commit" # 千万别忘！ git branch -M main # 确保分支名是 main git remote add origin <url> # 关联远程 git push -u origin main # 推送以及：不要创建名字太像的分支，0319exp和0319exp1真的会把自己搞晕 😅
问题 3：如何正确创建和管理分支
虽然之前用git checkout -b 0319exp创建了分支，但对其中的原理和最佳实践还是一知半解。经过一番研究，终于理清了工作流。
创建分支的正确姿势
从当前分支（main）创建新分支
bash
复制
# 确保你在 main 上，并且代码是最新的 git checkout main git pull origin main # 如果是协作项目，先同步远程 # 创建并切换到新分支（推荐写法） git checkout -b 0319exp # 或者先创建再切换 git branch 0319exp # 创建 git checkout 0319exp # 切换分支管理的实用命令
bash
复制
# 查看所有分支（本地+远程） git branch -a # 查看已合并到当前分支的分支（可以安全删除的） git branch --merged # 查看未合并的分支（删除时会警告） git branch --no-merged # 重命名分支（比如之前命名错了） git branch -m old-name new-name # 强制删除分支（如果改动没合并，普通删除会报错） git branch -D branch-name关键认知转变：
以前觉得分支很"重"，不敢轻易创建 → 现在明白分支只是一个指针，轻量且廉价
以前喜欢用日期命名 → 现在用功能命名，几个月后看分支名就知道做了什么
以前怕合并冲突 → 现在明白只要勤 commit、勤 push、勤从 main 更新，冲突很容易解决
这次踩坑虽然花了半小时，但把 Git 的分支逻辑彻底理清楚了。以后遇到src refspec报错，第一反应就是检查git status看有没有 commit，而不是怀疑远程地址错了。