如何通过修改 git config core.filemode false 规避因 Linux 文件权限变更造成的假文件冲突

直接在项目根目录执行 git config core.filemode false 即可让 Git 忽略文件权限变化，避免把 chmod 操作误判为“文件被修改”；这是因为 Linux 下文件权限属于 Git 跟踪的元信息，chmod 会触发 mode 变更导致假冲突，配置后需 git restore . 清除误报状态。

直接在项目根目录执行 git config core.filemode false 即可让 Git 忽略文件权限变化，避免把 chmod 操作误判为“文件被修改”。

为什么会出现假冲突

Linux 下文件权限（如 644、755）属于 Git 跟踪的元信息之一。当你用 chmod 批量调整 Laravel 的 storage 或 bootstrap/cache 目录权限时，Git 会把每个文件的 mode 变更（比如从 644 → 755）记录为“已修改”。即使内容没动，git status 也会列出大量文件，git pull 前也可能因“本地修改未提交”而拒绝更新。

正确配置方式

推荐按作用范围分情况设置：

• 仅当前项目生效：进入项目根目录后运行
  git config core.filemode false
• 所有项目统一生效（适合运维或开发机）：
  git config --global core.filemode false
• 验证是否生效：运行 git config core.filemode，输出 false 即成功；也可查看 .git/config 中是否出现 filemode = false

注意事项

这个设置只影响 Git 对“文件权限变更”的感知，不影响实际权限行为：

• 它不会还原你已改的权限，也不会阻止你后续再执行 chmod
• 如果项目已存在大量误报，执行配置后需运行 git reset --hard 或 git restore . 清除暂存区状态（确保无真正内容修改）
• 若之前设过 --global 但当前项目仍报错，检查 .git/config 是否有同名配置覆盖了全局设置——局部配置优先级更高

什么情况下不建议关闭 filemode

极少数场景需要严格管控可执行权限（例如部署脚本、二进制工具），此时应保留 core.filemode true，并通过 git update-index --chmod=+x xxx.sh 显式声明权限变更。普通 Web 项目（如 Laravel）基本无需此操作。