建议使用 ClangSharpPInvokeGenerator 生成 P/Invoke 绑定代码。在需要人工介入的情况下可以参照本文前半部分介绍绑定技巧的部分进行修改。生成绑定后仍然建议对其二次封装使之更符合 .NET 的使用习惯。
我在 OptimeGBA.io 中手写了 libvpx 的绑定，而用 ClangSharpPInvokeGenerator 生成了 libopenh264 的绑定，供各位对比绑定生成的质量。此外，这两个库的二次封装也可作为案例参考如何将 .NET 与非托管资源的互操作体验更加原生。
运行效果可以在此体验：https://aws.martincl2.me/OptimeGBA.io/。部署的版本使用了 h264 编码。
源码：https://github.com/Martin1994/es2018-linq
NPM：https://www.npmjs.com/package/es2018-linq
自我在短暂的金融业生涯中短暂地接触过 C# 之后，对 C# / .NET 的喜爱便一发不可收拾，即便从此之后的工作中再没机会使用 .NET 却依然保持着对其的关注，而这份关注与喜爱这也一直延续到了 Andre 老爷子如今的工作重心——TypeScript。
最近在工作中大量使用了 TypeScript，但却苦于没有合适的函数式编程工具箱。underscore/lodash 对异步方法的支持有限且不支持延迟执行；RxJS 又感觉太过重量级、强制异步，而 API 又自成一派。有 C# 背景的我自然是以 LINQ 对标这些库，所以我想要不干脆自己移植一份 LINQ 好了。
有些朋友可能对 C# 或是 LINQ 不太了解，在这里做一下简单的介绍。
LINQ 最初是设计成在 C# 代码中可以用类似 SQL 的方式操作一个可迭代对象（Enumerable），可以是普通的本地数据结构，甚至也可以是封装好的数据库操作。例如这个官方提供的样例：
|
1 2 3 4 5 6 7 |
int[] scores = new int[] { 97, 92, 81, 60 }; // Define the query expression. IEnumerable<int> scoreQuery = from score in scores where score > 80 select score; |
然而据我的理解，真正在代码里用 LINQ 语句的人并不多……大多数情况 LINQ 是直接通过扩展方法调用的：
|
1 2 3 4 |
int[] scores = new int[] { 97, 92, 81, 60 }; // Call LINQ methods IEnumerable<int> scoreQuery = scores.Where(score => score > 80); |
源码：https://github.com/Martin1994/JsonJitSerializer
NuGet：https://www.nuget.org/packages/MartinCl2.Text.Json.Serialization/
.NET Core 3.0 即将正式发布，其中一项令人振奋的功能是 corefx 集成了一个 JSON 库用来替代 JSON.NET，目前我按照 namespace 称这套库为 System.Text.Json。
这一套 JSON 库吸取了一部分 JSON.NET 的教训，将 API 的功能尽可能分离。例如它除了提供了 Object 与 String/Stream 之间的序列化与反序列化的高层 API 之外，还提供了逐 token 读写的底层 API。这为第三方开发者实现自己的 JSON 库提供了极大的方便。
了解到这一点后我意识到可以用这套底层 API（具体来说是 Utf8JsonWriter）来实现一个 just-in-time 编译（本质上其实是 IL generation）的 JSON 序列化库。
为何 JSON 序列化可以从 JIT 中受益呢？
System.Text.Json 实现 JSON 序列化的步骤是：
可以注意到步骤 2 到 3 其实有点类似于解释执行的脚本语言。既然是解释执行，那自然可以有其对应的 JIT 优化，将解释的内容直接编译成可执行的代码。这样可以省去一些存取的开销和动态类型检查的开销。具体可以减小多少开销可以参照 benchmark 的结果：
| Method | Mean | StdDev | Median | Min | Max | Gen 0/1k Op | Gen 1/1k Op | Allocated Memory/Op |
|---|---|---|---|---|---|---|---|---|
| System.Text.Json_Async | 592.6 ns | 1.3711 ns | 592.6 ns | 590.9 ns | 594.8 ns | 0.0471 | – | 304 B |
| MartinCl2.Text.Json_Async | 346.0 ns | 1.6620 ns | 345.4 ns | 344.4 ns | 349.2 ns | 0.0239 | – | 152 B |
vc4-fkms-v3d 是树莓派的开源 GPU 驱动，支持 OpenGL 2.1。正确配置的情况下 mesa 应该使用 V3D 驱动而不是 llvmpipe，后者使用的是 CPU。树莓派本来就贫弱的 CPU 并不经得起桌面渲染的折腾。此外 Chrome 也应能打开大多数硬件加速。
首先需要切换到开源驱动。前往 raspi-config -> Advanced Options -> GL Driver -> GL (Fake KMS)。树莓派 4 是默认使用这个开源驱动的。
最近买了第四代树莓派，但等到 SD 卡寄到了我才意识到我的读卡器忘记带在身边了。环顾四周，唯一有 SD 卡槽的居然只有那只老的树莓派 3B+。理论上我可以直接用 U 盘引导系统，但我不知为何一直无法成功。我更无法冒险将唯一可以引导系统的 SD 卡改为引导到 U 盘，因为万一失败了我在搞到读卡器之前都再也进不去系统了。
于是我就想到了一个骚操作：先用一张 SD 卡引导系统，ssh 进去，然后利用 pivot_root 将 root 转移到 SD 卡以外的地方（U 盘或者内存盘），这样我就能把引导系统的 SD 卡拔下来换新的上去了。全程都可以在 ssh 上完成。
Git Bash 在 WSL 出现之前一直是 Windows 开发必不可少的工具。哪怕不使用 unix toolchain，git 也是免不了要用的。在 WSL 出现后它依然没有退出历史舞台——至少 VS Code 目前还需要 Git for Windows 来整合 git 功能。此外，Git bash 是基于 MSYS2 开发的，而 MSYS2 在一些从 *nix 移植到 Windows 的项目上不可或缺。
然而，Git for Windows 中的 MSYS2 环境是刻意缩减过的。最重要的是他没有 pacman 包管理系统。如果不想装两份 MSYS2（一份完整的，一份 Git for Windows），那么 Git for Windows 官方提供了两种方案：使用 Git for Windows SDK，或在已有的 MSYS2 中安装 Git for Windows SDK。
注：Git for Windows 修改过 MSYS2 的运行环境。未经修改的运行环境不能很好的在 Windows 下互操作，例如 Powershell 中连 git status 都会无法执行。因此在 MSYS2 中安装 Git for Windows 会覆盖原版的 MSYS2 运行环境。
Git for Windows SDK 是一套为了开发 Git for Windows 而存在的环境。把这套 SDK 当 MSYS2 使用会有诸多不便。我只是想把完整的 MSYS 和 Git for Windows 合二为一而已，但在已有的 MSYS2 中安装 Git for Windows SDK 教程中却把 SDK 一同装上了。不装 SDK 其实很简单，不安装 git-extra 包即可。也就是最后一步的命令改为： pacboy sync git:x git-doc-html:x git-doc-man:x curl:x。
Electron 的 Renderer process 虽然和 main process 是不同的进程，但依然可以使用 node 的环境，比如 require(‘fs’) 之类. 但如果一个 js 脚本是在浏览器环境中用 <script> 标签加载的话，exports 变量是缺的，会报 exports is not defined.
而解决方法是不要使用 <script src=”./script.js”></script> 而是 <script>require(‘script’);</script>. 这样所有的脚本就是以 module 的方式加载而不是页面脚本了. 以 module 方式加载的脚本是有 exports 变量的.
本文将讲述如何在 VSCode 中使用 Attach 模式 Debug 的时候，也能像 Launch 模式一样一键启动 Debuggee. 具体原理是使用 preLaunchTask 并将此 Task 的 isBackground 属性设置为 true.
VS Code Debug Protocol 描述了两种不同的 Debug 方式：Launch 以及 Attach. 他们分别对应了 VSCode 负责启动程序并 Debug，以及 VSCode 去 Debug 一个正在运行的程序，包括非本地的程序.
其中，Launch 模式的潜在含义是，VSCode 将负责管理 Debuggee 的生命周期，也就是说 VSCode 负责启动及停止，而这些操作对于用户而言就是按一下按钮. 反观 Attach 则是另一种设计：用户必须自行启动 Debuggee，可以在本地可以在远程，只要 Debugger 能够与之通信，而 VSCode 只负责将 Debugger 与 Debuggee 对接.
在本地开发本地运行本地调试的情况下，Launch 无疑是最好的选择，因为一旦配置完毕，今后 Debug 只需要一键启动及一键停止. 这种开发环境十分的理想化，尽管可以满足大多数需求，但当环境变得复杂时，Attach 模式将是无法避免的. 例如执行代码的机器一定是在远程，这常见于跨平台开发，包括在 Windows 上使用 WSL 做 Linux 开发，以及使用 QEMU + GDB 做内核开发. 尽管微软在近期对一些官方插件就 WSL 进行了优化，即可以使用 Launch 模式在 WSL 中运行程序，但第三方插件仍然不可避免地需要使用 Attach.
在阅读前请注意，ssh-add 在没有 keychain 的情况下只能临时保存 SSH key. 也就是说重启 ssh-agent 后需要重新 ssh-add. 若要永久添加某个 SSH key，最快捷的方法是在 ~/.ssh/config 中添加 IdentityFile. 但如果要使用 SSH agent forwarding，就需要 ssh-agent 了.
在 WSL 中自动启用 ssh-agent 并不是那么直接，因为 WSL 的入口 bash.exe 并不能继承来自父进程关于 ssh-agent 的环境变量，毕竟父进程是个 Windows 进程. 此外另一点特殊的地方在于，当所有 bash.exe 进程结束的时候，所有的 WSL 进程会被杀掉，包括 ssh-agent.
ssh-agent 的启动比较特殊. 手动启动的方式是：
|
1 |
eval $(ssh-agent); |
这是因为 ssh-agent 默认执行两件事：1. 后台运行 ssh-agent；2. 输出一段 shell script 以供执行. 这段 shell script 中包含着与这次启动的 ssh-agent 通信所需的环境变量.
一般情况下，例如在 Linux 桌面环境里，在桌面环境启动前 ssh-agent 就被启动并且环境变量也被设置了. 之后启动的桌面环境，以及桌面环境启动的 Terminal 都会自动继承这个环境变量.
由于一些很蠢的原因，我写了一份完全用不着的用于计算 Lambert W function 的 C# 代码. 具体原理是很粗暴的牛顿法求解，但有几个特别处理的地方：
首先是估算. W0比较好处理，其实随便给个初始值就好，我这里选择了偏移后的 ex. 而 W-1 则比较特殊，首先在 x < -2 的部分变成了 concave 的，而且越往左斜率越小，所以一律从 x = -2 开始尝试；而在 -2 < x < -1 的区间内其实也是随便给个初始值就好，我这里选择了偏移后的 cos 函数.
其次是精度处理. 通过 log2x 做差可以求出二进制下的有效数位，然而当 y 值较大的时候其实并不能把完整的 52 位双精度浮点数的小数部分求完整，大概只能求到 47 位左右，所以这里我保守选择了 42 位有效数字.