git push 后 文件夹异常打不开

git push 发现有个文件 夹 变成了 FunASR @ c0b2079 且无法点开查看内容

问题根源

FunASR @ c0b2079 这种格式表示该文件夹是 Git Submodule(子模块) 或 Git Submodule的残留/未完整初始化状态 ,也可能是 git-lfs/稀疏检出导致的特殊引用,本质是Git将该目录标记为指向另一个仓库特定提交(c0b2079 是提交哈希)的引用,而非普通文件夹,因此无法直接点开查看内容。

核心解决步骤(分场景处理)

场景1:误引入Submodule,需要转为普通文件夹

如果这个文件夹本应是项目内的普通目录,却被误标记为Submodule,按以下步骤修复:

步骤1:删除Submodule引用(保留文件)
bash 复制代码
# 1. 先删除.gitmodules中对应的Submodule配置(如果存在)
git rm --cached FunASR  # 关键:仅删除Git对Submodule的引用,不删除本地文件
rm -rf .git/modules/FunASR  # 删除Submodule的本地缓存(如果有)

# 2. 编辑.git/config,删除[submodule "FunASR"]相关配置(如果存在)
# 可直接用编辑器打开:vim .git/config

# 3. (可选)如果.gitmodules文件存在,删除其中FunASR的配置段
# 例如:sed -i '/\[submodule "FunASR"\]/,+3d' .gitmodules

# 4. 将FunASR重新加入Git追踪(转为普通文件)
git add FunASR/
git commit -m "移除FunASR的Submodule标记,转为普通文件夹"
git push
步骤2:验证修复

推送后重新拉取仓库,FunASR 会恢复为普通文件夹,可正常点开查看内容。

场景2:确实需要Submodule,仅需初始化查看内容

如果该文件夹本就是作为Submodule引入的(依赖其他仓库),需要初始化Submodule才能查看内容:

bash 复制代码
# 1. 初始化并拉取Submodule代码
git submodule init  # 初始化Submodule配置
git submodule update --recursive  # 拉取Submodule对应提交的代码

# (或一步到位)
git submodule update --init --recursive FunASR

# 2. 此时FunASR文件夹会被填充代码,可正常查看
# 推送时Submodule的引用会被保留,协作者拉取时也需执行上述update命令
场景3:Submodule已损坏/残留,强制清理

如果是Submodule残留导致的异常,强制清理后重新添加:

bash 复制代码
# 1. 彻底删除Submodule相关痕迹
git rm -f FunASR
rm -rf FunASR/.git  # 如果FunASR内有.git文件夹(Submodule残留)
rm -rf .git/modules/FunASR

# 2. 提交删除操作
git commit -m "清理损坏的FunASR Submodule"

# 3. 将FunASR作为普通文件夹重新加入
cp -r /备份的FunASR目录/ ./FunASR  # 恢复本地文件(如果已删除)
git add FunASR/
git commit -m "重新添加FunASR为普通文件夹"
git push

关键补充说明

  1. 为什么会出现这种格式?

    • 执行过 git submodule add <仓库地址> FunASR 命令,误将目录设为Submodule;
    • 拉取代码时未执行 git submodule update,Submodule未初始化;
    • 拷贝/移动文件时带入了其他仓库的 .git 文件夹,Git识别为Submodule。
  2. 避免后续踩坑的注意事项

    • 不要在项目内嵌套 .git 文件夹(会被Git识别为Submodule);
    • 引入Submodule前确认必要性,非必要优先复制文件而非用Submodule;
    • 推送前执行 git status 检查,避免意外提交Submodule引用。
  3. 验证是否彻底解决

    推送后,在Git仓库网页端查看:

    • 正常文件夹:显示为文件夹图标,可点击展开;
    • 仍为Submodule:显示为 FunASR @ c0b2079 样式,需重新执行上述步骤。
相关推荐
7177776 小时前
国内 AI 研发效能工具怎么选:2026 年基于公开信息的选型框架与 Gitee 实践
人工智能·gitee
Hvitur1 天前
Git - 多分支合并
git·github
考虑考虑1 天前
git刷新远程分支列表
git·后端·gitlab
AI大模型-小华2 天前
Codex 自动测试怎么用?从生成测试用例到修复失败用例
git·测试用例·ai编程·软件开发·codex·chatgpt pro·codex cli
七分辣度2 天前
GitHub/Git 常用命令及使用场景
git·github
慧都小项3 天前
MyEclipse Inline Diff 实用指南:逐处核对 AI 修改再提交
git·ai编程·myeclipse·java 代码审查·ai 代码修改
德育处主任4 天前
让 Claude Code 在你睡觉时接着干活:tmux、权限策略与验收清单
git·ai编程·命令行
为思念酝酿的痛6 天前
Git基本操作
git·github
7177776 天前
国产研发中台怎么选:以 Gitee 为锚点的技术决策参考
gitee
7177777 天前
支持混合云的 DevOps 平台有哪些:Gitee、Azure DevOps、GitLab、Jenkins、JFrog 横向对比
gitee·azure·devops