如何用Git保留默认配置文件并实现本地修改不被追踪？

这是我在团队协作中常用的方案，完美解决你提到的所有痛点——既能在仓库里保留默认配置的「权威版本」，本地修改不会被Git追踪，还能让新成员快速上手，不用重复执行繁琐的命令。

具体步骤如下：

1. 重命名现有配置文件为模板文件 #

首先，把仓库中已提交的*.config.php文件重命名为带.dist后缀的模板文件（比如app.config.php → app.config.php.dist），这样它就作为默认配置保留在仓库里：

# 单个文件的情况
git mv app.config.php app.config.php.dist

# 如果有多个配置文件，可以用批量命令（bash环境）
for file in *.config.php; do
    git mv "$file" "$file.dist"
done

然后提交这个重命名操作：

git commit -m "Rename config files to default templates (.dist)"

2. 让Git忽略本地实际配置文件 #

把*.config.php添加到.gitignore中，确保Git不会追踪本地修改的配置文件：

echo "*.config.php" >> .gitignore
git add .gitignore
git commit -m "Add local config files to gitignore"

3. 给团队成员的初始化步骤 #

新成员克隆仓库后，只需要把模板文件复制为实际的配置文件，就可以在本地修改了：

# 单个文件
cp app.config.php.dist app.config.php

# 批量复制所有模板文件（bash环境）
for dist_file in *.config.php.dist; do
    cp "$dist_file" "${dist_file%.dist}"
done

进阶优化：一键初始化脚本 #

为了让新成员更省心，可以写一个简单的初始化脚本（比如setup-config.sh），提交到仓库中：

#!/bin/bash
# 自动生成本地配置文件，仅当文件不存在时创建

for dist_file in *.config.php.dist; do
    config_file="${dist_file%.dist}"
    if [ ! -f "$config_file" ]; then
        cp "$dist_file" "$config_file"
        echo "✅ Created local config: $config_file"
    else
        echo "ℹ️ Local config already exists: $config_file"
    fi
done

给脚本添加执行权限并提交：

chmod +x setup-config.sh
git add setup-config.sh
git commit -m "Add config setup script for new team members"

之后新成员只需要运行./setup-config.sh，就能自动生成所有本地配置文件，完全不用手动处理每个文件。

为什么这比其他方法好？ #

• 避免了git rm --cached或git update-index --assume-unchanged这类需要每个成员手动执行多次的繁琐操作
• 仓库里的.dist文件始终保留最新的默认配置，新成员能直接获取
• 本地配置文件完全独立，修改不会被Git检测到，也不会意外提交到仓库

内容的提问来源于stack exchange，提问作者user9383457