解决 Pycharm 在 WSL 中 Git 权限问题

本文链接：https://blog.csdn.net/qq_41821483/article/details/146136601

解决 Pycharm 在 WSL 中 Git 权限问题（应该适用于所有JetBrains IDE）

问题描述

当通过 Windows 主系统 启动 JetBrains IDE（如 PyCharm）并打开 WSL 中的项目时，Pycharm中的Git 功能可能无法正常使用，常见现象包括：

报错 fatal: detected dubious ownership in repository
在终端中，用户切换切换到项目文件夹所有者后，使用命令行（如git fetch等）能正常使用，但是Pycharm的Git模块却无法使用

控制台会输出下面的信息：

16:58:45.531: [ArcheGS-server] /usr/bin/git -c credential.helper= -c core.quotepath=false -c log.showSignature=false fetch origin --recurse-submodules=no --progress --prune
fatal: detected dubious ownership in repository at '/home/eksulfur/ArcheGS-server'
To add an exception for this directory, call:
git config --global --add safe.directory /home/eksulfur/ArcheGS-server

但是即使执行 git config --global --add safe.directory 也无法解决，因为问题根源在于 WSL 用户权限配置 和 IDE 运行环境。

原因分析

默认用户问题：
WSL 默认以 root 用户运行 IDE 的 Git 命令，导致项目文件所有者变为 root，与普通用户权限冲突。
路径混淆：
从 Windows 主系统直接打开 WSL 路径（如 \\wsl$\Ubuntu\home\user）时，IDE 可能无法正确继承 WSL 用户身份。

终极解决方案

步骤 1：配置 WSL 默认用户

修改 WSL 配置文件，强制指定默认用户为普通账户：

# 在 WSL 中执行
sudo nano /etc/wsl.conf

添加以下内容（替换 your_username 为实际用户名）：

[user]
default = your_username

保存后重启 WSL：

# 在 Windows PowerShell 中执行
wsl --shutdown
wsl

步骤 2：通过 IDE 的「远程开发」功能连接 WSL

关闭当前项目：
在 PyCharm 中选择 File > Close Project，返回启动界面。
选择 WSL 开发模式：
点击 Remote Development > WSL，选择你的 WSL 发行版（如 Ubuntu）。
按加号打开项目
选择合适的IDE版本，点击“安装选项…”->“自定义安装路径”检查不是在root路径下
选择项目

关键原理

WSL 用户隔离：通过 wsl.conf 强制指定默认用户，避免 root 权限污染。
IDE 远程模式：使用「远程开发」功能让 IDE 直接在 WSL 用户环境中运行，而非通过 Windows 桥接。
路径一致性：确保项目路径始终为 WSL 原生格式（如 /home/user），而非 Windows 挂载路径（如 /mnt/c）。

注意事项

避免混合权限操作：
不要通过 sudo 执行 Git 命令或在 Windows 资源管理器中直接修改 WSL 文件。
检查 IDE 更新：
确保使用 2021.2+ 版本 的 JetBrains IDE，以支持完整的 WSL 集成。
修复历史遗留权限：
如果已有项目文件所有者为 root，执行：
```
sudo chown -R $USER:$USER /home/your_username/your-project
```