解决VS Code中Ballerina项目搭建的'Not Found'错误

云上老周

2026-6-16

可能的原因及排查方向

路径配置细节错误：检查VS Code中ballerina.home的配置是否为绝对路径，路径中是否包含空格、中文或特殊字符（比如&、#）。另外，修改配置后需完全重启VS Code才能生效，仅刷新窗口可能不触发配置重载。
扩展与SDK版本不兼容：Ballerina VS Code扩展对SDK版本有明确要求，比如部分旧扩展不支持最新的Ballerina 2.x版本，反之亦然。可以查看扩展详情页的版本兼容说明，尝试将SDK或扩展升级/降级到匹配版本。
环境变量未被VS Code读取：如果是在终端临时设置的环境变量，通过桌面图标启动的VS Code可能无法加载到。尝试关闭所有VS Code窗口，从已加载环境变量的终端执行code .命令启动VS Code，再检查错误是否消失。
SDK目录权限不足：在Linux/macOS系统中，若SDK安装在/usr或/opt等系统目录，普通用户运行的VS Code可能无读取权限。可以将SDK重新安装到用户目录（比如~/ballerina），或执行chmod -R 755 <你的SDK路径>调整目录权限。
扩展缓存损坏：VS Code的Ballerina扩展缓存可能因异常关闭或更新损坏。关闭VS Code后，删除对应扩展文件夹（Windows：%USERPROFILE%\.vscode\extensions，Linux/macOS：~/.vscode/extensions中带有ballerina字样的文件夹），然后重新安装Ballerina扩展。
项目配置或路径问题：当前项目的Ballerina.toml可能存在语法错误，或者项目路径包含特殊字符。尝试用bal new test-project命令新建一个空白项目，在VS Code中打开，若错误消失则说明原项目本身存在问题。