Mac环境下Theia执行yarn启动无报错但无法运行求助

问题重现 #

在MacBook上按以下步骤部署Theia Hello World扩展：

sudo port install npm6
sudo port install nvm
sudo npm install -g yo generator-theia-extension
sudo npm install -g theia
mkdir theia-hello-world-extension
cd theia-hello-world-extension
yo theia-extension # 选择'Hello World'选项并完成配置
nvm install 10
nvm use 10
yarn start:browser

执行后命令快速完成，但3000端口无服务运行，桌面也无任何界面弹出，命令输出如下：

yarn start:browser
yarn run v1.22.19
$ yarn rebuild:browser && yarn --cwd browser-app start
$ theia rebuild:browser
$ theia start
✨ Done in 3.83s.

Electron启动的情况同样异常：

yarn start:electron
yarn run v1.22.19
$ yarn rebuild:electron && yarn --cwd electron-app start
$ theia rebuild:electron
$ theia start
✨ Done in 3.96s.

排查与解决步骤 #

1. 确认Node.js版本环境有效性 #

执行以下命令检查当前shell是否真的切换到了Node.js 10：

node -v

如果输出不是v10.x.x，说明nvm环境变量未生效，执行：

source ~/.nvm/nvm.sh
nvm use 10

再重新运行启动命令。

2. 清理并重建本地依赖 #

全局安装的Theia可能和项目本地依赖版本冲突，先清理本地依赖：

rm -rf node_modules package-lock.json yarn.lock
yarn install

然后重新执行构建和启动：

yarn rebuild:browser
yarn start:browser

3. 开启调试日志排查错误 #

默认日志级别无法展示启动失败的细节，修改启动命令增加日志输出：

yarn start:browser --log-level debug

查看输出中的错误信息，比如端口占用、依赖缺失、权限问题等。

4. 移除全局Theia避免版本冲突 #

全局安装的Theia容易和项目本地版本不一致，导致启动失败，先卸载全局版本：

sudo npm uninstall -g theia

回到项目目录重新执行：

yarn install
yarn start:browser

5. 检查端口占用情况 #

确认3000端口是否被其他程序占用：

lsof -i :3000

如果有占用进程，杀掉对应PID后再启动：

kill -9 <PID>

6. Electron启动额外修复 #

若Electron启动无响应，先检查是否安装XQuartz（Mac运行Electron的依赖组件），再强制重建Electron依赖：

yarn rebuild:electron --force
yarn start:electron

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