如何在不使用Docker Desktop的Windows系统中运行Docker Compose
解决WSL中Docker Engine搭配Docker Compose及Visual Studio 2022的问题
一、在WSL中安装Docker Compose
方法1:安装Docker Compose CLI插件(推荐)
适用于Docker Engine 20.10及以上版本:
- 更新软件包索引:
sudo apt update - 安装插件:
sudo apt install docker-compose-plugin - 验证安装:
显示版本信息则安装成功。docker compose version
方法2:安装独立二进制文件
适配旧版Docker Engine:
- 下载对应架构的最新二进制文件:
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose - 添加执行权限:
sudo chmod +x /usr/local/bin/docker-compose - 验证安装:
此方法使用docker-compose versiondocker-compose命令(带横杠)。
二、配置Visual Studio 2022连接WSL Docker Engine
步骤1:确保WSL Docker服务持续运行
- 启动Docker服务:
sudo systemctl start docker - 设置开机自启(可选):
sudo systemctl enable docker
步骤2:让Visual Studio识别WSL Docker实例
方式A:通过系统环境变量配置
- 打开Windows「系统属性」→「高级」→「环境变量」
- 添加系统变量:
DOCKER_HOST=unix://\\wsl$\<你的WSL发行版名称>\var\run\docker.sock(例如unix://\\wsl$\Ubuntu-22.04\var\run\docker.sock) - 重启Visual Studio使其读取新配置。
方式B:修改Visual Studio容器工具设置
- 点击「工具」→「选项」→「容器工具」→「Docker Compose」
- 在「Docker daemon」下拉菜单中选择你的WSL发行版
- 保存设置后重启Visual Studio。
步骤3:排查MSB4018构建错误
若仍出现该错误:
- 确认WSL内
docker compose up命令可正常执行 - 检查Visual Studio「容器工具」中「目标OS」与WSL容器的操作系统匹配(如Linux)
- 执行「生成」→「清理解决方案」后重新构建项目
内容的提问来源于stack exchange,提问作者Augusto Ferbonink
相关产品推荐
相关产品推荐

