解决 TortoiseGit 安全目录问题的自动化脚本

在 Windows 10 上，你可以创建一个 PowerShell 脚本来自动为当前 Git 仓库添加安全目录。这个脚本会处理路径格式转换问题，并适用于多个仓库。

PowerShell 脚本解决方案

创建一个名为 Add-SafeDirectory.ps1 的脚本文件：

powershell
# 获取当前 Git 仓库的根目录
$repoPath = git rev-parse --show-toplevel 2>$null

if (-not $repoPath) {
    Write-Host "当前目录不是 Git 仓库根目录或子目录" -ForegroundColor Red
    exit 1
}

# 将路径转换为适合 git config 的格式（正斜杠）
$safePath = $repoPath -replace '\\', '/'

# 添加安全目录
git config --global --add safe.directory "$safePath"

Write-Host "已添加安全目录: $safePath" -ForegroundColor Green

使用方法

1. 将上述脚本保存为 Add-SafeDirectory.ps1
2. 在 Git 仓库目录中打开 PowerShell
3. 运行脚本：.\Add-SafeDirectory.ps1

更便捷的全局使用方法

如果你想在任何地方都能使用这个脚本：

1. 将脚本保存到你的用户目录下的某个位置，比如 C:\Users\YourName\scripts\
2. 将该目录添加到系统 PATH 环境变量中
3. 然后你就可以在任何 Git 仓库中直接运行 Add-SafeDirectory 命令了

批处理版本（备用）

如果你更喜欢使用传统的批处理脚本，可以创建一个 add_safe_dir.cmd 文件：

batch
@echo off
for /f "delims=" %%i in ('git rev-parse --show-toplevel 2^>nul') do set "repoPath=%%i"

if "%repoPath%"=="" (
    echo 当前目录不是 Git 仓库根目录或子目录
    pause
    exit /b 1
)

set "safePath=%repoPath:\=/%"
git config --global --add safe.directory "%safePath%"

echo 已添加安全目录: %safePath%
pause

注意事项

1. 这些脚本需要在 Git 仓库目录或其子目录中运行
2. 脚本会自动检测当前仓库的根目录
3. 路径中的反斜杠会被自动转换为正斜杠，以满足 git config 的要求
4. 如果你使用的是 Git Bash，可以直接在 Git Bash 中运行类似的 Bash 脚本

这个解决方案可以让你一键添加当前仓库为安全目录，无需手动复制粘贴路径。

---

Git Bash 一键添加安全目录的解决方案

既然你使用的是 Git Bash，我可以提供一个更简洁的 Bash 脚本来解决这个问题。Git Bash 使用 Unix 风格的路径，所以处理起来会更简单。

创建 Bash 脚本

在你的用户目录下创建 .bashrc_safe_directory 文件（或直接添加到现有的 .bashrc 中）：

bash
# 添加到 ~/.bashrc 或单独创建文件后 source 它
function add_safe_directory() {
    # 获取当前 Git 仓库根目录
    local repo_path=$(git rev-parse --show-toplevel 2>/dev/null)
    
    if [ -z "$repo_path" ]; then
        echo -e "\033[31m错误：当前目录不是 Git 仓库\033[0m"
        return 1
    fi
    
    # 在 Git Bash 中路径已经是 Unix 格式
    git config --global --add safe.directory "$repo_path"
    echo -e "\033[32m已添加安全目录: $repo_path\033[0m"
}

使用方法

1. 将上述代码添加到你的 ~/.bashrc 文件中
2. 执行 source ~/.bashrc 或重新打开 Git Bash
3. 在任何 Git 仓库目录中，只需运行：

   bash
   add_safe_directory
   

更简单的单行命令版本

如果你不想修改 .bashrc，可以直接在任何 Git 仓库中运行：

bash
git config --global --add safe.directory "$(git rev-parse --show-toplevel)"

一次性修复所有现有仓库

如果你想一次性为所有现有的 Git 仓库添加安全目录（假设它们都在 ~/Projects/ 目录下）：

bash
find ~/Projects -type d -name '.git' -exec sh -c 'git config --global --add safe.directory "${0%/.git}"' {} \;

注意事项

1. 这些命令需要在 Git 仓库目录或其子目录中运行
2. Git Bash 已经使用 Unix 风格的路径分隔符（正斜杠），所以不需要转换
3. 如果你在 Windows 资源管理器中右键使用 "Git Bash Here"，脚本会自动识别正确的仓库路径

这个解决方案充分利用了 Git Bash 的环境特性，比 Windows 原生的解决方案更加简洁。

---

错误原因及解决方案

错误原因

你遇到的错误信息表明：

fatal: detected dubious ownership in repository at 'K:/Projects/vitepress-theme-teek-docs-template'
'K:/Projects/vitepress-theme-teek-docs-template' is on a file system that does not record ownership

这个错误是由于：

1. Git 的安全机制检测到仓库所在的文件系统（K:盘）无法正确记录文件所有权信息（常见于网络驱动器、外接硬盘或某些Windows配置）
2. Git 默认不信任这种无法确定所有权的仓库，以防止潜在的安全风险

解决方案

方法1：直接运行Git建议的命令（推荐）

错误信息中已经给出了解决方案：

bash
git config --global --add safe.directory K:/Projects/vitepress-theme-teek-docs-template

方法2：使用修正后的脚本

修改之前的脚本，避免使用git rev-parse来获取路径（因为它在不被信任的仓库中会失败）：

bash
function add_safe_directory() {
    # 使用pwd获取当前目录（Git Bash已自动转换路径格式）
    local repo_path=$(pwd)
    
    git config --global --add safe.directory "$repo_path"
    echo -e "\033[32m已添加安全目录: $repo_path\033[0m"
}

方法3：禁用安全检查（不推荐）

如果你完全信任这台电脑上的所有仓库，可以临时禁用这个检查：

bash
git config --global --unset-all safe.directory
git config --global --add safe.directory "*"

⚠️ 警告：这会允许所有仓库，降低安全性，仅推荐在完全信任的环境中使用

最佳实践建议

1. 推荐使用方法1：精确添加需要信任的目录
2. 如果K:是网络驱动器，考虑将仓库放在本地磁盘（如C:盘）可能会避免这个问题
3. 如果是公司/团队共享项目，确保所有协作者都添加了相同的安全目录配置

为什么之前的命令会失败？

因为git rev-parse --show-toplevel本身就需要访问Git仓库，但在仓库未被标记为安全前，Git会拒绝执行这个命令，形成了"先有鸡还是先有蛋"的问题。

---

这个错误是因为路径中的换行导致 Git Bash 将命令截断了。在 Git Bash 中，当路径太长时可能会自动换行，但直接复制粘贴会导致命令不完整。

正确的解决方法

方法1：使用引号包裹完整路径

bash
git config --global --add safe.directory "K:/Projects/vitepress-theme-teek-docs-template"

方法2：使用相对路径（更简单）

既然你已经在仓库目录中，可以直接使用：

bash
git config --global --add safe.directory "$(pwd)"

方法3：使用自动补全

输入以下命令后按 Tab 键自动补全路径：

bash
git config --global --add safe.directory K:/Pro<Tab>

（按 Tab 键会自动补全剩余路径）

为什么会出现这个问题？

1. 你的路径中有换行（可能是终端自动换行导致的）
2. 没有用引号包裹包含空格的路径
3. 直接复制粘贴时包含了换行符

验证是否成功

添加后可以检查：

bash
git config --global --get-all safe.directory

应该能看到你添加的路径。

---