批处理脚本转换SYMLINK为SYMLINKD及Git符号链接同步问题

首先得明确：Windows里的SYMLINK是文件符号链接，SYMLINKD是目录符号链接，这俩是不同类型的链接，没法直接“转换”，只能先删掉原来的文件链接，再重新创建目录链接。下面给你写个实用的批处理脚本，带注释的那种：

@echo off
:: 替换成你要处理的链接名称
set "LINK_NAME=你的链接名"

:: 先检查链接是否存在
if not exist "%LINK_NAME%" (
    echo 抱歉，指定的链接不存在，退出脚本
    exit /b 1
)

:: 提取原文件链接的目标路径（只处理SYMLINK类型）
for /f "tokens=2 delims=[]" %%i in ('dir /a:l "%LINK_NAME%" ^| findstr "<SYMLINK>"') do set "TARGET=%%i"

:: 确认拿到了有效目标路径
if not defined TARGET (
    echo 这不是有效的文件符号链接，无法处理
    exit /b 1
)

:: 删除原文件符号链接
del "%LINK_NAME%"

:: 创建目录符号链接（SYMLINKD）
mklink /D "%LINK_NAME%" "%TARGET%"

echo 搞定！已经把SYMLINK转换成SYMLINKD啦

⚠️ 注意：运行这个脚本需要管理员权限，而且要确保原链接的目标是一个目录，不然创建SYMLINKD会失败哦。

这种情况我碰到过不少，其实是Git的跨平台特性搞的鬼——Git本身不区分Windows特有的SYMLINK和SYMLINKD，它只把符号链接当作一种统一的类型存储。当你在本地创建SYMLINKD推送到仓库，其他机器克隆时，Git会尝试根据目标类型创建链接，但经常因为权限或配置问题，变成了SYMLINK。下面给你分步解决：

• 第一步：配置Git支持Windows符号链接
  先确保克隆机器的Git开启了符号链接支持，打开管理员权限的命令提示符或Git Bash，运行：

  git config --global core.symlinks true
  

  这个配置是全局的，设置一次就行。

• 第二步：用管理员权限克隆仓库
  克隆的时候一定要用管理员权限的终端，不然Git没有权限创建SYMLINKD，只能生成SYMLINK。

• 如果已经克隆完出现错误链接，手动修复

  1. 先删掉错误的链接：如果是显示的，用del Annotations；如果是目录但不对，用rmdir Annotations
  2. 重新创建目录链接：

     mklink /D Annotations ..\..\submodules\Annotations\Assets
     

• 进阶：给团队加个一键修复脚本
  为了避免其他成员踩坑，你可以在仓库里加个批处理脚本fix_symlinks.bat，内容如下：

  @echo off
  echo 正在修复目录符号链接...
  mklink /D Annotations ..\..\submodules\Annotations\Assets
  echo 修复完成！
  

  把这个脚本提交到Git，其他人克隆后直接双击运行（记得用管理员权限）就能搞定。

总的来说，Git对Windows专属的SYMLINKD支持确实有限，核心还是靠本地环境配置和小脚本辅助来解决。

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