vscode找不到mojo运行时，主因是modular_home未被正确识别，需在设置中手动配置mojo.modularhomepath，且路径必须包含pkg/packages.modular.com_mojo/子目录，wsl场景须先打开对应发行版窗口再配置。
VSCode找不到Mojo运行时：MODULAR_HOME没生效
Mojo扩展启动失败、右上角▶️按钮灰掉、F5调试报“command 'mojo.debug' not found”，基本都是MODULAR_HOME路径没被正确识别。它不是靠系统环境变量自动继承的，VSCode（尤其Remote-WSL场景）会忽略终端里生效的export MODULAR_HOME=...。
- 优先在VSCode设置里手动填
mojo.modularHomePath，值为/home/username/.modular（Linux/WSL）或C:\Users\XXX\AppData\Roaming\Modular\.modular（Windows本地，极少用） - 如果用WSL，必须先通过
Ctrl+Shift+P→Remote-WSL: New Window Using Distro打开对应发行版窗口，再配置mojo.modularHomePath，否则扩展加载的是Windows侧上下文 -
MODULAR_HOME指向目录必须包含pkg/packages.modular.com_mojo/子路径，否则扩展会静默跳过——可执行ls $MODULAR_HOME/pkg/packages.modular.com_mojo/bin/mojo验证
点击运行没反应：终端没挂载，不是没执行
点右上角▶️后无输出、无弹窗、PROBLEMS面板也空，常见于首次使用或WSL连接刚建立时。这不是代码或配置错误，而是VSCode Mojo扩展默认不强制唤起集成终端，只把命令发给后台进程。
- 提前打开一个集成终端（
Ctrl+`），再点▶️，输出会直接刷进该终端 - 若已点过多次，检查
ps aux | grep mojo确认进程是否已在后台跑着——别反复点击，可能堆积多个实例 - 想让每次运行都自动开新终端，目前无原生开关，可临时用
Task替代：.vscode/tasks.json里定义shell类型任务，调用mojo run ${file}
调试器F5失败：LLDB路径未就绪
按F5提示“Failed to launch LLDB”或“Cannot find lldb-mi”，说明Mojo SDK自带的调试器组件缺失或权限异常。Mojo的modular install mojo虽含LLDB，但不会自动注册到系统PATH，也不保证二进制可执行。
- 进入
$MODULAR_HOME/pkg/packages.modular.com_mojo/bin/，确认存在lldb-mi（Linux/WSL）或lldb-mi.exe（Windows）文件 - 执行
chmod +x lldb-mi（Linux/WSL），否则VSCode无法调用 - 若仍失败，尝试在
launch.json中显式指定"miDebuggerPath"，值为上述lldb-mi的绝对路径 - 注意：WSL2中调试需确保Windows端已安装
Windows Subsystem for Linux Update，旧内核（如5.10.x）可能不兼容LLDB-MI协议
代码补全和悬停失效：SDK版本与扩展不匹配
Ctrl+Space无提示、Ctrl+K Ctrl+I悬停空白、函数签名（Ctrl+Shift+Space）不滚动——大概率是Mojo SDK版本太新或太旧，超出了当前VSCode Mojo扩展的解析能力。
- 查当前扩展版本：VSCode扩展页搜“Mojo ?”，看发布日期；官方扩展更新滞后于SDK，0.2.x SDK常需0.4.0+扩展才支持
- 查SDK版本：
mojo --version输出末尾的commit hash（如2f0dcf11），去GitHub releases比对是否属已验证兼容范围 - 临时降级方案：用
modular install mojo@0.1.11锁旧版（需先modular clean），避免每日构建版引入破坏性变更 - 重启VSCode窗口（非仅重载窗口），扩展的Language Server进程需完全重建才能加载新版SDK语义模型
MODULAR_HOME写错一位、WSL分发版选错一个、甚至~/.modular目录权限是700而非755，都可能导致某个功能静默失效——建议每次变更后，用mojo run --help在终端直连验证SDK可用性，再切回VSCode。
