FoxLang for Visual Studio Code
FoxLang 官方语言支持插件 —— 为 FoxLang 编程语言提供完整的编辑体验:
- 语法高亮(TextMate,与官方词法分析器逐条对照)
- 语言服务器(LSP):语法诊断、函数跳转、悬停文档、智能补全、符号大纲
- 一键运行 & 语法检查:直接调用
fox.exe,错误自动显示在问题面板
- 代码片段、语言配置(
#/#* *# 注释、括号匹配与自动闭合、折叠缩进)
- 双主题:FoxLang Dark / FoxLang Light
功能
语法高亮
覆盖全部关键字、int/double/string/void/dict 类型、内建函数、注释、数字、字符串、运算符、函数声明与调用。
语言服务器(IntelliSense)
- 诊断:未闭合字符串/块注释、非法字符、分号误用、括号不匹配,保存时即时报错
- 跳转定义:
Ctrl+点击 函数调用处,跨文件跳转到 func 声明
- 悬停:关键字/类型/内建函数中文文档;函数调用显示签名与定义位置
- 补全:关键字、类型、内建函数、工作区内已定义的函数(
Ctrl+Space)
- 大纲:
func 函数列表(Ctrl+Shift+O)
运行与检查(需要 fox.exe)
- 命令面板 FoxLang: Run FoxLang Script(
Ctrl+Alt+R,或编辑器标题栏 ▶ 按钮):先编译为 .fc,再在集成终端中运行
- 命令面板 FoxLang: Check FoxLang Syntax:仅编译检查,错误写入问题面板
- 保存文件后自动检查(可关闭)
fox.exe 自动查找顺序:设置 foxlang.foxExecutable → PATH → C:\FoxLang\fox.exe → C:\Program Files\FoxLang\fox.exe → 工作区根目录。找不到时会引导你手动指定。
设置项
| 设置 |
默认 |
说明 |
foxlang.foxExecutable |
"" |
fox.exe 完整路径,留空自动查找 |
foxlang.checkOnSave |
true |
保存后自动编译检查 |
开发
npm install
npm run compile # 编译客户端 + 语言服务器到 out/
npm test # LSP 逻辑冒烟测试 + 语法快照测试
npx vscode-tmgrammar-snap -u "test/grammar/fixtures/**/*.fox" # 更新语法快照
按 F5 启动 Extension Development Host 调试。
打包发布
npx @vscode/vsce package
code --install-extension foxlang-0.2.0.vsix
语言速览
import fox.std.util -> u
func add(a <- int, b <- int) -> int {
ret a + b
}
func main() -> void {
print("3 + 4 = ")
println(add(3, 4))
end
exit(0)
}
已知问题
- VM 运行
.fc 之前必须先完成一次 -c 编译(本插件已自动处理)。
- 诊断为轻量级实现:不做完整语法树校验,深层错误以 fox.exe 检查结果为准。
- 库名免路径导入(
import 库名)为编译器层功能,尚未实现。
许可
Apache-2.0
| |