.fs 文件与 YAML 嵌入块带来语法高亮、智能补全、注解/片段模板与函数目录同步能力。
本章总结其安装方式、常用配置及维护流程，便于团队快速统一开发体验。
功能概览
- 语法高亮：覆盖关键字、变量引用、运算符与注解块。
- 基本补全：关键字、系统函数、扩展函数、链式
::调用及当前工作区的def/fun块均可被建议，并附带参数占位符。 - 注解提示：输入
@即出现内置注解（默认@except）模板。 - 代码片段：
def、when、try等前缀可展开为常用结构；括号与引号自动闭合。 - YAML 嵌入：在 YAML 中使用
: ;启用 Fluxon 区块，补全与语法提示与.fs文件一致。
安装与更新
- 在 VS Code 的扩展视图搜索 “Fluxon” 并安装，或手动导入
.vsix包。 - 若需本地构建：
- 打开 “扩展” 视图 → 右上角
…→ “从 VSIX 安装” 选择生成的包。
仓库附带
vscode-extension/demo/ 与 vscode-extension/data/fluxon-functions.json，便于测试补全是否生效。命令与快捷操作
常用片段前缀：
def、defb、async、for、when、try、import、@。
配置选项
在settings.json 中搜索 Fluxon 可调节以下参数：
函数目录同步
补全依赖运行时导出的fluxon-functions.json。新增函数时需重新生成并同步：
Fluxon: Refresh Function Catalog 以刷新内存缓存。
本地调试流程
- 在
vscode-extension中运行pnpm run watch，保持 TypeScript 编译。 - 在 VS Code 中按
F5启动 “扩展开发主机”。 - 在新窗口打开
.fs或demo/test.yml，验证补全与语法高亮。 - 修改代码后调试窗口会自动热重载，如需重新拉取目录可重复执行上节命令。
常见问题
.fs误识别为 F#：点击状态栏语言模式，手动切换为 “Fluxon”。- 补全缺少新函数：确认已执行
dumpFluxonCatalog与sync-catalog，并运行刷新命令。 - YAML 中无补全：确保 Fluxon 代码前加
;，例如onLoad: ;print('hi')。