VSCode运行Mojo必须手动配置mojo.modularHomePath,路径须精确到pkg/packages.modular.com_mojo/子目录;WSL需先打开对应发行版窗口再配置,否则读取Windows路径无效;点▶️无输出是因未挂载终端,需提前按Ctrl+`开启;F5调试失败需检查lldb-mi存在性、执行权限及launch.json中miDebuggerPath显式路径。

VSCode 要跑 Mojo,不是装个扩展就完事——MODULAR_HOME 配不对其路径,所有功能(运行、调试、补全)都会静默失效,连右上角▶️按钮都灰掉。
mojo.modularHomePath 必须手动填,且路径要精确到 pkg/packages.modular.com_mojo/
VSCode 不继承终端里设的 export MODULAR_HOME=,尤其在 Remote-WSL 场景下,它压根读不到。必须进设置搜 mojo.modularHomePath,手敲完整路径:
- Linux / WSL:填
/home/username/.modular(确认该目录下存在pkg/packages.modular.com_mojo/bin/mojo) - Windows 本地(极少用):填
C:\Users\XXX\AppData\Roaming\Modular\.modular - WSL 用户注意:先按
Ctrl+Shift+P→Remote-WSL: New Window Using Distro打开对应发行版窗口,再配,否则配的是 Windows 侧路径,无效
点▶️没输出?不是代码问题,是终端没挂载
Mojo 扩展默认不自动唤起集成终端,只把命令发给后台进程。常见现象:点击后无任何反应、PROBLEMS 面板空、也看不到错误。
- 提前按
Ctrl+`打开一个集成终端,再点▶️,输出会直接刷进该终端 - 若已反复点击,执行
ps aux | grep mojo查看是否堆积多个mojo run进程,避免资源占用 - 想每次运行都新开终端?目前无原生开关,可临时建
.vscode/tasks.json,定义shell类型任务调用mojo run ${file}
F5 调试失败:“Failed to launch LLDB”?检查 lldb-mi 权限和路径
Mojo SDK 自带 lldb-mi,但不会注册进 PATH,也不保证可执行。
- 进
$MODULAR_HOME/pkg/packages.modular.com_mojo/bin/,确认存在lldb-mi(Linux/WSL)或lldb-mi.exe(Windows) - Linux/WSL 下执行
chmod +x lldb-mi,否则 VSCode 无法调用 - 仍失败?在
.vscode/launch.json中显式指定"miDebuggerPath",值为lldb-mi的绝对路径 - WSL2 用户注意:需已安装 Windows Subsystem for Linux Update,旧内核(如 5.10.x)可能不兼容 LLDB-MI 协议
Mojo 的坑不在语法,而在环境链路太脆:MODULAR_HOME 路径错一位、WSL 窗口开错上下文、lldb-mi 少个 chmod,整条链就断。别信“自动识别”,每个环节都得亲手验证。


















