AEON Linux下Distrobox环境中VS Code启动进入URL Handler模式的原因及解决方法

嘿，我之前在Distrobox环境里折腾VS Code的时候也碰到过类似的问题，给你理清楚为啥会这样，以及怎么解决：

问题原因 #

你这个情况主要是Distrobox隔离环境和桌面启动参数的适配问题：

• 桌面文件里的%F参数是用来传递选中的文件/文件夹路径的，但当你直接点击图标启动（没有选中任何文件）时，这个参数会传递一个空值给Distrobox里的VS Code
• VS Code在接收到无法识别的空参数或者非预期的启动上下文时，会误触发"URL Handler"模式，就出现了你看到的那个窗口标题
• 另外AEON Linux的桌面环境在处理跨容器应用的启动参数时，可能和原生系统有细微差异，进一步加剧了这个识别问题

你提供的.desktop文件确实没有直接配置URL Handler，但参数传递的异常导致了这个行为：

[Desktop Entry]
Name=Visual Studio Code (on essentials)
Comment=Code Editing. Redefined.
GenericName=Text Editor (on essentials)
Exec=/usr/bin/distrobox-enter -n essentials -- /usr/share/code/code %F
Icon=vscode
Type=Application
StartupNotify=false
StartupWMClass=Code
Categories=TextEditor;Development;IDE;
MimeType=application/x-code-workspace;
Actions=new-empty-window;
Keywords=vscode;
[Desktop Action new-empty-window]
Name=New Empty Window (on essentials)
Name[cs]=Nové prázdné okno (on essentials)
Name[de]=Neues leeres Fenster (on essentials)
Name[es]=Nueva ventana vacía (on essentials)
Name[fr]=Nouvelle fenêtre vide (on essentials)
Name[it]=Nuova finestra vuota (on essentials)
Name[ja]=新しい空のウィンドウ (on essentials)
Name[ko]=새 빈 창 (on essentials)
Name[ru]=Новое пустое окно (on essentials)
Name[zh_CN]=新建空窗口 (on essentials)
Name[zh_TW]=開新空視窗 (on essentials)
Exec=/usr/bin/distrobox-enter -n essentials -- /usr/share/code/code --new-window %F
Icon=vscode

解决步骤 #

• 修改桌面文件的启动参数 #

  最直接的办法是调整Exec行的参数，避免传递空的文件参数：

  • 打开你的VS Code桌面文件（通常在~/.local/share/applications/或者/usr/share/applications/目录下）
  • 把主Exec行改成：

    Exec=/usr/bin/distrobox-enter -n essentials -- /usr/share/code/code
    

    （去掉末尾的%F，这样启动时强制打开普通窗口，不传递文件参数）
  • 同时把"New Empty Window"动作里的Exec行也改成：

    Exec=/usr/bin/distrobox-enter -n essentials -- /usr/share/code/code --new-window
    

    同样去掉%F

• 验证并修正窗口类（可选但推荐） #

  有时候窗口管理器识别异常也会导致标题显示问题：

  • 打开VS Code（不管是哪个模式），在终端运行xprop WM_CLASS，然后点击VS Code窗口
  • 你会看到类似WM_CLASS(STRING) = "Code", "Code"的输出
  • 如果你的桌面文件里StartupWMClass的值和这个不一致，就改成输出里的第二个值（比如这里的Code）

• 重新加载桌面文件 #

  修改完后，让系统刷新桌面数据库：

  • 如果是用户目录下的桌面文件：

    update-desktop-database ~/.local/share/applications/
    

  • 如果是系统目录下的：

    sudo update-desktop-database /usr/share/applications/
    

• 测试启动 #

  现在点击VS Code图标，应该就能正常打开普通窗口，不会再出现"URL Handler"的标题了。如果需要打开特定文件，直接拖拽文件到图标上，或者在VS Code里通过菜单打开，依然可以正常工作。

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