树莓派OS arm64执行wp-env start报错spawn docker-compose ENOENT

1. 修复.wp-env.json配置文件缺失问题 #

• 必须在WordPress项目根目录执行wp-env start，wp-env默认读取项目根目录的配置文件。
• 若没有配置文件，直接在项目根创建.wp-env.json，基础配置示例如下（可根据开发场景调整）：

{
  "core": "WordPress/WordPress",
  "plugins": [ "./" ]
}

2. 解决spawn docker-compose ENOENT错误 #

树莓派OS使用的是Docker Compose V2（集成在Docker CLI中，命令为docker compose），但wp-env默认查找V1的docker-compose命令，shell别名因Node子进程不读取shell配置而失效，可尝试以下两种方案：

方案一：创建软链接替代别名 #

直接为docker compose创建docker-compose软链接，让系统能直接识别该命令：

sudo ln -s /usr/bin/docker /usr/local/bin/docker-compose

执行docker-compose --version验证，能正常显示版本信息即为生效。

方案二：指定wp-env使用Docker Compose V2命令 #

• 项目级配置：在项目根的.wp-env.json中添加环境变量配置：

{
  "core": "WordPress/WordPress",
  "plugins": [ "./" ],
  "env": {
    "DOCKER_COMPOSE_COMMAND": "docker compose"
  }
}

• 全局配置：设置系统环境变量，让所有wp-env实例生效：

echo 'export DOCKER_COMPOSE_COMMAND="docker compose"' >> ~/.bashrc
source ~/.bashrc

额外检查项 #

• 确认Docker服务正在运行：sudo systemctl status docker，未启动则执行sudo systemctl start docker。
• 确保当前用户属于docker用户组（避免权限问题）：sudo usermod -aG docker $USER，执行后重新登录生效。

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