WSL 2运行gitk.exe无法识别WSL文件系统内Git仓库问题咨询

gitk.exe是Git for Windows提供的Win32原生程序，无法直接解析WSL 2虚拟磁盘的Linux格式路径：

• 在WSL内部文件系统路径（如~/projects/repo）下直接调用时，程序接收到的工作目录是Linux格式的/home/用户名/projects/repo，Windows侧无对应盘符映射，无法定位目录，因此返回"Cannot find a git repository here"错误。
• 在/mnt/c/这类Windows分区挂载路径下调用时，路径可直接对应到Windows侧的盘符路径，gitk.exe可正常识别，因此可以运行。

方案1：配置路径自动转换别名（推荐，无额外依赖） #

借助WSL自带的wslpath工具，调用gitk.exe时自动将Git仓库路径转换为Windows可识别的\\wsl$\<发行版名>\UNC路径，配置shell别名后可永久生效：

1. 打开当前Shell的配置文件：如果使用Bash则编辑~/.bashrc，使用Zsh则编辑~/.zshrc，在文件末尾添加以下别名配置：

alias gitk='gitk.exe --git-dir="$(wslpath -w "$(git rev-parse --git-dir)")" --work-tree="$(wslpath -w "$(git rev-parse --show-toplevel)")"'

2. 执行source ~/.bashrc（替换为你实际修改的配置文件路径）让配置立即生效。后续在任意WSL内的Git仓库（包括子目录）下直接执行gitk即可正常启动、识别仓库。

方案2：安装WSL原生Linux版gitk #

如果无强制使用Windows版gitk的需求，直接在WSL内安装Linux原生编译的Git和gitk即可，不存在路径兼容问题：

• Debian/Ubuntu系发行版执行以下命令安装：

sudo apt update && sudo apt install -y git gitk

安装完成后直接执行gitk即可调用原生版本，完美适配WSL虚拟磁盘内的所有路径。

方案3：临时手动转换路径调用 #

如果只是临时使用不想修改配置，可以手动将当前路径转换为Windows可识别格式后再调用程序，在仓库目录下执行：

gitk.exe --git-dir="$(wslpath -w "$(git rev-parse --git-dir)")" --work-tree="$(wslpath -w "$(git rev-parse --show-toplevel)")"

• 不建议为WSL虚拟磁盘目录映射固定Windows盘符访问，容易出现两边权限不一致，导致Git索引损坏、文件权限异常的问题。
• 若配置别名后启动出现文件访问报错，检查Windows侧是否开启了WSL网络路径的访问权限，默认配置下该权限是开启状态，无需额外调整。

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