WSL Debian环境下Git推送无法启动浏览器认证的问题求助

问题重现 #

执行git push -u origin main触发浏览器认证时，出现报错：

info: please complete authentication in your browser...
fatal: Failed to locate a utility to launch the default web browser.

已配置git-credential-manager，尝试过设置BROWSER环境变量和Git全局浏览器配置，但问题未解决。

解决方案 #

1. 安装WSL浏览器调用工具wslu #

wslview是WSL环境中调用Windows浏览器的核心工具，Debian默认未预装，需手动安装：

sudo apt update && sudo apt install wslu

2. 正确配置BROWSER环境变量 #

在~/.zshrc中设置环境变量，确保使用wslview作为浏览器启动器：

export BROWSER="wslview"

执行以下命令使配置立即生效：

source ~/.zshrc

3. 修正Git全局浏览器配置 #

之前的配置中使用了HTML转义字符"，导致路径识别错误，需重新配置：

• 若用wslview调用Windows默认浏览器：

git config --global web.browser wslview

• 若指定Brave浏览器，需使用WSL格式路径（而非Windows的C:\格式）：

git config --global web.browser brave
git config --global browser.brave.path "/mnt/c/Program Files/BraveSoftware/Brave-Browser/Application/brave.exe"

4. 验证浏览器启动功能 #

在WSL终端执行以下命令，确认能正常打开浏览器：

wslview https://github.com

若无法打开，检查Windows中Brave的安装路径是否正确，或确保WSL具备调用Windows程序的权限。

备选方案：使用个人访问令牌（PAT）跳过浏览器认证 #

若浏览器认证仍无法正常工作，可直接使用Git平台（如GitHub/GitLab）生成的PAT作为凭证推送：

git push https://<你的用户名>:<你的PAT>@github.com/<用户名>/<仓库名>.git main

也可配置Git保存凭证，避免每次输入：

git config --global credential.helper store

首次推送时输入用户名和PAT，Git会自动保存凭证。

内容的提问来源于stack exchange，提问作者Juan David Arias