Linux Mint环境下VS Code执行npm run脚本无法找到已存在可执行文件的问题问询

The Problem #

When running npm run icons in VS Code on Linux Mint, you hit this error:

ls: cannot access '/usr/bin/convert': No such file or directory
The terminal process "/usr/bin/bash '-l', '-c', 'npm run icons'" terminated with exit code 2.

But the exact same bash script works flawlessly in a regular terminal window. The root cause here is almost certainly that your VS Code is installed via Flatpak—runs in an isolated sandbox container, so it can't directly access binaries from your host system like /usr/bin/convert.

Why This Happens #

Flatpak apps operate in a restricted sandbox by default. Any path adjustments you made in ~/.profile only apply to your host shell, not the sandboxed VS Code environment. That’s why the script works in a regular terminal (host environment) but fails in VS Code (sandbox).

The Solution #

Update your generate-icons.sh script to detect if it’s running inside a Flatpak sandbox, and use flatpak-spawn --host to call the host system’s ImageMagick tools. Here’s the tested fix:

# ------------------------------------------------------------
# Detect Flatpak or host environment
# Locate ImageMagick (prefer magick over convert)
# ------------------------------------------------------------
if [[ -n "${FLATPAK_ID:-}" ]]; then
    # We're inside a Flatpak sandbox—use flatpak-spawn to access host commands
    FP=(flatpak-spawn --host)
    IMG_CMD=$(flatpak-spawn --host which magick || flatpak-spawn --host which convert)
else
    # Running on the host system—directly locate the command
    FP=()
    IMG_CMD=$(command -v magick || command -v convert)
fi

# Error out if ImageMagick isn't found on the host
if ! [[ -n "${IMG_CMD:-}" ]]; then
    echo "Error: ImageMagick not installed on your host system." >&2
    exit 1
fi

echo "Using ImageMagick command: ${FP[@]} $IMG_CMD"

Key Details #

• Flatpak Detection: We check for the FLATPAK_ID environment variable, which is automatically set inside Flatpak sandboxes.
• Host Command Access: flatpak-spawn --host lets us run commands from the host system within the sandbox.
• Version Compatibility: The script looks for magick (the newer ImageMagick command) first, then falls back to convert for older installations.
• Error Handling: If ImageMagick isn’t installed on your host, the script will clearly notify you instead of failing silently.

Quick Debugging Tip #

If you still run into issues, add these lines to your script to verify the environment:

echo "Current FLATPAK_ID: ${FLATPAK_ID:-not set}"
flatpak-spawn --host ls -l /usr/bin/convert 2>/dev/null || echo "convert not found on host"

This will help confirm if the Flatpak host access is working and if ImageMagick is properly installed.

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