C# F#与C#互操作方法 C#如何调用F#库

c#可直接引用f#编译的dll，但需注意：f#模块函数在c#中为静态方法（如modulename+module），option/result/list等类型需通过fsharpoption等对应类使用，并引用匹配版本的fsharp.core；async需用startastask转为task；顶层let绑定不导出，必须置于module或type中。

C# 直接引用 F# 编译后的 DLL 就能调用

F# 生成的是标准 .NET 程序集（.dll），和 C# 编译出的完全兼容。只要 F# 项目输出为类库（dotnet new classlib -lang f#），C# 项目通过 Add Project Reference 或 PackageReference 引入，就能像调用普通 C# 类一样使用其公开类型和方法。

注意：F# 默认启用 RequireQualifiedAccess 的模块（如 List、Option）在 C# 中不可直接访问，必须显式调用静态成员；而标记为 [<entrypoint>] </entrypoint> 的函数或顶层 let 绑定（未包装在模块/类中）不会导出到元数据，C# 看不见。

• F# 模块中的函数在 C# 中表现为 Static 方法，所属类名为 ModuleName+Module（例如 MyUtils+Module）
• 若想让 F# 函数在 C# 中更自然，用 type 包装成类，并加 [<compiledname>]</compiledname> 控制暴露名
• F# 的 unit 对应 C# 的 void，但返回 unit 的函数在 C# 中仍需声明为 void 调用——不能赋值给变量

F# 的 Option、Result、List 等类型在 C# 中怎么用

C# 无法原生理解 F# 特有类型，但它们是普通泛型类，可直接实例化和调用。比如 Option<t></t> 在 C# 中就是 FSharpOption<t></t>，位于 FSharp.Core 程序集中。

关键点：C# 必须引用 FSharp.Core（NuGet 包或 GAC），且版本需与 F# 库编译时一致，否则会出现 Could not load type 'microsoft.FSharp.Core.FSharpOption`1' 错误。

• FSharpOption<String>.Some("hello")</string> 和 FSharpOption<string>.None</string> 是主要构造方式
• FSharpResult<t tError></t> 同理，用 FSharpResult<int string>.Ok(42)</int> 或 .Error("fail")
• F# 的 List 在 C# 中是 FSharpList<t></t>，不支持 linq ToList() 直接转换，得用 FSharpList<t>.OfSeq(myArray)</t>

从 C# 调用 F# 的异步工作流（async { … }）

F# 的 async 工作流编译后是 FSharpAsync<t></t> 类型，不是 .NET 的 Task<t></t>。C# 不能直接 await 它，必须先转成 Task。

转换依赖 FSharp.Core 提供的扩展方法：FSharpAsync.StartAsTask（推荐）或 FSharpAsync.ToStartableTask（需手动 Start()）。

• 最常用写法：await myFSharpAsync.StartAsTask().ConfigureAwait(false)
• 若 F# async 可能抛异常，确保 C# 层捕获的是 AggregateException 内层异常（FSharpAsync 包装过一层）
• 避免在 UI 线程直接调用 StartAsTask() 后同步 .Result，会死锁；务必 await

命名冲突与可见性控制：F# 默认不导出顶层 let 绑定

F# 文件顶部的 let x = 1 或 let add a b = a + b 不会生成任何公共成员，C# 完全不可见——这是初学者最常踩的坑。

要让 C# 调用，必须把逻辑放进 module（推荐）或 type，并确保没有 private 修饰：

• 正确示例：

  module Calculator =     let Add (a: int) (b: int) = a + b

  → C# 中调用 Calculator.Add(1, 2)

• 错误示例：

  let internal Helper = "hidden" let Add a b = a + b // 无 module / type 包裹，不导出

• 若需类式调用，用 type math() = static member Add a b = a + b，C# 中为 Math.Add(1, 2)

F# 编译器对可见性的处理比 C# 更“静默”：没显式标记 public 或包进作用域，就等于不存在。调试时可用 ildasm 或 JetBrains dotPeek 查看实际导出的类型和方法签名。