VSCode无法运行Mojo代码主因是MODULAR_HOME路径未正确配置：需在设置中手动填写mojo.modularHomePath，Linux/WSL填/home/username/.modular且必须包含pkg/packages.modular.com_mojo/子目录，WSL场景须先通过Remote-WSL打开对应发行版窗口再配置。
VSCode 无法运行 Mojo 代码，90% 是 MODULAR_HOME 路径没填对或没在正确的上下文里填——它不继承终端环境变量，尤其在 WSL 场景下必须先打开对应发行版窗口再配。
mojo.modularHomePath 必须手动填且路径要精确到 pkg/packages.modular.com_mojo/
VSCode 的 Mojo 扩展不会读取系统级 MODULAR_HOME 环境变量，哪怕你在终端里 export MODULAR_HOME=~/.modular 并验证过 mojo --version 正常，VSCode（尤其是 Remote-WSL）也完全无视。
- 打开 VSCode 设置（
Ctrl+,），搜索mojo.modularHomePath - Linux/WSL 填：
/home/yourname/.modular（注意不是~/.modular，不能用波浪号） - Windows 本地极少用，路径类似：
C:\Users\XXX\AppData\Roaming\Modular\.modular - 填完后，**必须验证该路径下存在
pkg/packages.modular.com_mojo/bin/mojo**，否则扩展静默失效——可执行ls $MODULAR_HOME/pkg/packages.modular.com_mojo/bin/mojo确认
WSL 用户必须先开对应发行版窗口再配置
如果你装了多个 WSL 发行版（比如 Ubuntu-22.04 和 Ubuntu-24.04），而 Mojo 只装在其中一个里，直接在 Windows 启动的 VSCode 里填路径是无效的：扩展加载的是 Windows 侧上下文，根本找不到 Linux 下的二进制。
- 按
Ctrl+Shift+P→ 输入Remote-WSL: New Window Using Distro - 从列表中选你装了 Mojo 的那个发行版（如
Ubuntu-22.04） - 在这个新窗口里打开设置，再填
mojo.modularHomePath - 重启这个 WSL 窗口，确保右下角状态栏显示
WSL: Ubuntu-22.04
点 ▶️ 没反应？不是没运行，是终端没挂载
首次点击右上角运行按钮后无输出、PROBLEMS 面板空、也没弹窗——这几乎肯定不是代码或路径问题，而是 Mojo 扩展默认不自动唤起集成终端，只把命令发给后台进程。
- 提前按
Ctrl+`打开一个集成终端 - 再点 ▶️，输出会直接刷进这个终端
- 如果已反复点击，执行
ps aux | grep mojo查看是否堆积了多个mojo run进程，避免资源浪费 - 想每次自动开新终端？目前无原生开关，可临时建
.vscode/tasks.json，定义 shell 类型任务："command": "mojo run ${file}"
F5 调试失败：lldb-mi 权限或路径不对
报错 Failed to launch LLDB 或 Cannot find lldb-mi，说明 Mojo SDK 自带的调试器组件没被正确识别。它虽随 modular install mojo 安装，但不注册进 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": "/home/yourname/.modular/pkg/packages.modular.com_mojo/bin/lldb-mi" - WSL2 用户注意：旧内核（如 5.10.x）可能不兼容 LLDB-MI 协议，需升级 Windows Subsystem for Linux Update
最易被忽略的一点：Mojo SDK 版本和 VSCode Mojo 扩展版本必须匹配。截至 2026 年 4 月，扩展对 mojo 0.2.1 以上版本的补全/悬停支持不稳定，若发现 hover 不出类型、Ctrl+Click 跳转失效，先检查 mojo --version 输出，再确认扩展是否为最新版——不是“已启用”就等于“兼容”。
