Git子模块:关联外部仓库同时使用本地修改的单个文件
保留Git子模块关联同时使用本地修改的主题文件
当然可以!而且有两种靠谱的方案,你可以根据是临时修改还是长期维护需求来选:
方法1:Fork原主题仓库并更新子模块指向(推荐长期使用)
这种方式能让你的自定义修改被版本控制,同时还能保留和原主题仓库的关联,方便后续同步官方更新:
- 先把原主题仓库fork到你自己的GitHub账号下(就是点原仓库页面的Fork按钮,复制一份到你的账号里)。
- 回到你的Hugo项目根目录,更新子模块的远程地址,指向你自己的fork:
git submodule set-url themes/terminal https://github.com/你的用户名/hugo-theme-terminal.git - 进入主题子模块目录,提交你的修改到自己的fork仓库:
cd themes/terminal git add 你修改的文件名 git commit -m "自定义修改:比如调整了首页布局/修改了样式" git push origin main - 后续如果想同步原主题的官方更新,只需要给子模块添加原仓库为上游远程,然后合并更新即可:
要是合并时出现冲突,直接解决冲突后提交就行,你的自定义修改会被保留。cd themes/terminal git remote add upstream https://github.com/panr/hugo-theme-terminal.git git fetch upstream git merge upstream/main
方法2:本地临时保留修改(适合短期测试)
如果你只是临时改改试试,不想折腾fork仓库,也可以直接让子模块处于“脏”状态:
- 你的修改会让子模块目录在
git status里显示为未提交的改动,只要你不执行git submodule update --force,本地修改就会一直保留。 - 但如果之后需要拉取原主题的更新,建议先把本地修改暂存起来,避免被覆盖:
拉完更新再恢复你的修改,有冲突的话手动解决就行。不过这种方式不适合长期用,因为修改没被版本控制,换电脑或者重新克隆项目就没了。cd themes/terminal git stash git pull origin main git stash pop
内容的提问来源于stack exchange,提问作者user3498593
相关产品推荐
相关产品推荐

