如何在Windows 10的WSL2中启用Windows资源管理器的TortoiseGit GUI

前提准备 #

• 已安装WSL2及对应Linux分发版（如Ubuntu）
• Windows端已安装TortoiseGit及Git（TortoiseGit依赖Git环境）

操作步骤 #

1. 访问WSL2的文件系统
   打开Windows文件资源管理器，在地址栏输入\\wsl$并回车，就能看到所有已安装的WSL分发版。进入你正在使用的分发版目录，找到你的Git代码仓库所在路径。

2. 直接用TortoiseGit操作仓库
   在WSL共享目录里，右键点击目标代码仓库文件夹，即可看到TortoiseGit的右键菜单（如Commit、Push、Pull等），直接选择对应功能操作即可。

   • 首次操作需配置Git用户名和邮箱：右键→TortoiseGit→Settings→Git→Configure，填写user.name和user.email。

3. 映射网络驱动器（可选，提升操作便捷性）
   为了避免每次输入\\wsl$路径，可将WSL的代码目录映射为Windows本地盘符：

   • 右键“此电脑”→选择“映射网络驱动器”
   • 选择一个未使用的盘符（如Z:），在“文件夹”输入框中填写\\wsl$\<你的分发版名称>\<代码仓根路径>（例如\\wsl$\Ubuntu\home\yourname\projects）
   • 勾选“登录时重新连接”，点击确定后即可像访问本地磁盘一样操作WSL内的代码。

常见问题解决 #

• 换行符不一致导致的变更：WSL内代码默认使用LF换行，Windows端Git可能自动转换为CRLF，引发不必要的提交变更。解决方法：
  右键仓库文件夹→TortoiseGit→Settings→Git→Config，添加以下配置：

  core.autocrlf = false
  core.eol = lf
  

• 文件权限引发的错误：Windows与WSL的权限映射可能导致Git检测到不必要的权限变更。解决方法：
  打开WSL终端，进入代码仓库目录，执行命令：

  git config core.filemode false
  

  关闭Git对文件权限变更的检测。

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