迁移到Linux后Git无法识别文件夹符号链接，求解决方案

Git对目录符号链接的核心限制 #

Git本身不会索引目录符号链接指向的内容——它只会将符号链接视为一个特殊的文本文件，仅存储链接的目标路径，不会递归跟踪链接目录里的文件。你设置的core.symlinks=true只是允许Git在仓库中存储符号链接这个文件本身，而非让Git展开并跟踪链接指向的目录内容，这是Git的设计逻辑决定的。

可行的替代方案 #

结合你的PHP多项目共用代码场景，以及无sudo权限的限制，推荐以下几种方案：

1. Git子模块（Git Submodules）

将Master中的共用模块拆分为独立的Git仓库，在各个项目中通过子模块引用，实现版本化的共用代码管理：

• 把Master/Administrator、Master/Modules/News分别做成独立的Git仓库（可托管在服务器本地的裸仓库中）
• 在Project A的仓库中执行：

  git submodule add <Administrator仓库的本地路径或URL> Administrator
  

• 在Project B的仓库中执行：

  git submodule add <News仓库的本地路径或URL> Modules/News
  

• 后续更新共用代码时，在子模块目录中拉取最新版本，再提交项目仓库的子模块版本变更即可。
  优点：每个项目可独立锁定共用代码的版本，版本控制清晰；缺点：子模块操作有一定学习成本，更新需要同步子模块和主仓库。

2. Git工作区挂载（Git Worktree）

如果Master本身是Git仓库，且所有项目与Master在同一服务器上，可通过git worktree将Master的目录直接挂载到各个项目中：

• 假设Master仓库位于/path/to/Master，在Project A中执行：

  git worktree add /path/to/ProjectA/Administrator main
  

  （main是Master仓库的目标分支）
• 同理，在Project B中挂载News目录：

  git worktree add /path/to/ProjectB/Modules/News main
  

优点：无需额外仓库，共用内容实时同步，操作简单；缺点：所有项目共用Master的同一分支版本，无法单独定制，适合共用代码无版本差异的场景。

3. PHP代码加载路径配置（推荐）

利用PHP的加载机制，完全绕开文件系统链接的限制，这也是PHP项目共用代码的常规做法：

• 修改include_path：在每个项目的入口文件（如index.php）中添加：

  $masterPath = realpath(__DIR__ . '/../Master');
  set_include_path(get_include_path() . PATH_SEPARATOR . $masterPath);
  

  之后直接通过include 'Administrator/xxx.php'即可引用共用文件。
• Composer本地依赖：如果项目使用Composer，在每个项目的composer.json中添加本地仓库引用：

  {
    "repositories": [
      {
        "type": "path",
        "url": "../Master"
      }
    ],
    "require": {
      "your-namespace/master": "*"
    }
  }
  

  执行composer install后，Composer会自动将Master的代码映射到项目的vendor目录（或自定义路径），通过命名空间直接引用即可。
  优点：符合PHP项目开发规范，无文件系统链接的兼容性问题；缺点：需要调整项目的代码加载逻辑（若之前依赖硬链接的路径）。

4. 文件级硬链接（仅适合少量文件）

Linux支持文件硬链接，若共用的是少量单个文件，可逐个创建硬链接：

ln /path/to/Master/Administrator/config.php /path/to/ProjectA/Administrator/config.php

但如果是多层目录结构，此方法维护成本极高，不推荐。

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