OpenSUSE Tumbleweed下git instaweb配置问题：/etc/gitweb-common.conf无法读取

• 问题根源：git instaweb每次启动都会重写仓库内的.git/gitweb/gitweb_config.perl，直接修改该文件无法保留自定义配置。
• 全局配置文件无效原因：默认情况下git instaweb不会自动加载/etc/gitweb.conf或/etc/gitweb-common.conf，必须显式指定配置文件路径。

解决步骤 #

1. 创建自定义配置文件
   新建一个不会被覆盖的配置文件（比如/etc/gitweb-local.conf），写入以下配置：

   $feature{'highlight'}{'default'} = [1];
   $feature{'blame'}{'default'} = [1];
   

2. 启动时加载自定义配置
   运行git instaweb时通过参数指定配置文件：

   git instaweb --start --gitweb-config=/etc/gitweb-local.conf
   

3. 配置永久生效（可选）
   将配置路径写入git全局配置，后续启动无需重复指定参数：

   git config --global instaweb.gitwebConfig /etc/gitweb-local.conf
   

完成上述操作后，刷新gitweb页面，Blame功能即可正常使用，代码高亮也会自动启用。

内容的提问来源于stack exchange，提问作者Marcelo Roberto Jimenez