在IntelliJ IDEA中运行WSL的docker compose命令报错，该如何解决？

我在Windows 10上安装了带Ubuntu的WSL和docker-compose插件，目前可在PowerShell或IDEA终端通过wsl docker compose up（v2版本）正常运行命令。但使用IntelliJ IDEA的docker-compose配置运行时出现错误：

wsl --env-file -f C:\Users\myName\IdeaProjects\microservices\music-app\docker-compose.yml -p music-app up /bin/bash: line 1: /: Is a directory 'docker-compose' process finished with exit code 126

同时有两个疑问：

1. 为何wsl后没有docker compose命令？
2. IDEA可正常运行容器和镜像，已修改Docker配置，请问该检查哪些内容、遗漏了什么？

一、解决IDEA docker-compose配置运行报错 #

报错是因为IDEA生成的命令格式错误，参数传递混乱，按以下步骤调整：

• 打开IDEA的Run/Debug Configurations，找到你的docker-compose配置项
• 在Docker Compose标签页，确认Command字段只填写up（或up -d这类正常命令参数），不要添加wsl前缀或其他多余参数
• 切换到Docker下拉选择框，确保选中的是与WSL Ubuntu关联的Docker实例。如果没有这个选项，前往IDEA设置Settings -> Build, Execution, Deployment -> Docker，添加WSL类型的连接，地址填写unix:///var/run/docker.sock
• 检查Environment标签页，确认没有错误配置的环境变量，避免出现--env-file这类不属于环境变量的参数

二、关于“wsl后没有docker compose命令”的说明 #

你在PowerShell中执行的wsl docker compose up，本质是通过wsl命令调用WSL环境内的docker compose up指令，而非wsl命令本身包含docker compose参数。正确的命令逻辑是wsl [WSL环境内要执行的完整命令]。
如果直接进入WSL Ubuntu终端后无法执行docker compose，检查以下内容：

• 在WSL终端执行docker --version和docker compose version，确认Docker及Compose v2已正常安装
• 如果docker compose命令找不到，可能是Compose插件未正确配置路径，执行sudo ln -s /usr/libexec/docker/cli-plugins/docker-compose /usr/bin/docker-compose建立软链接（适配插件式安装的Compose v2）
• 确认WSL内当前用户已加入docker用户组：执行sudo usermod -aG docker $USER，退出后重新登录WSL生效

三、额外检查项 #

• 打开Docker Desktop设置，确认Use the WSL 2 based engine已勾选，同时在Resources -> WSL Integration中开启对应Ubuntu发行版的集成开关
• 更新IDEA的Docker插件到最新版本，避免版本兼容问题
• 确认WSL Ubuntu的系统版本及Docker版本适配，无版本冲突

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