funide 开源：把 IDE 也交出去

# funide 开源：把 IDE 也交出去

八月三十一日 Fun 开源，今天整一个月，IDE 也开源了。地址在 <https://github.com/Funlang/funide>，MIT 授权。

funide 不是新东西。它是 Fun 的 Windows 桌面 IDE：中间一列标签页编辑器，右边一栏文件树，树底下接查找/输出窗，编译、运行、断点这些按钮在顶上那排工具栏，编辑器底下压一条状态栏。官网首页那张截图，2018 年 1 月挂上去的，八年没换。谁下载过 `fun.zip`（1.1MB），解开来就有 `funide.exe`（1.6MB），旁边跟着一个 `funide.exe.presets`。用过 Fun 的人，多半都开过它。

只是源码一直放在作者自己机器上，没往外放。今天交出来了。

## 一、仓库里有什么

一层目录，两份东西：

```text
funide/
├── src/
│   ├── ide/          # IDE 本体
│   └── prj/ide/      # Delphi 工程 + Windows 构建脚本
└── syntaxes/
    └── fun.tmLanguage.yaml   # TextMate 语法
```

`src/ide` 里是六个 Pascal 单元加一个窗体：

| 文件 | 行数 | 干什么 |
| --- | --- | --- |
| `ide.pas` | 2903 | 全部所在：类型、引擎胶水、主窗体逻辑 |
| `ide.dfm` | 2300 | 主窗体布局 |
| `funsyntax.pas` | 1060 | Fun 语法高亮（SynGen 生成） |
| `fdsyntax.pas` | 627 | FD 语法高亮（手写） |
| `regexsyntax.pas` | 603 | 正则语法高亮 |
| `debug.pas` | 82 | 调试类的骨架 |

再加一个 30 行的 `funide.dpr`，源码一共五千三百来行。

（吐槽：占大头的 `ide.pas` 一个文件近三千行，能一个文件写完就不拆。好在命名都直白，读起来不费劲。）

## 二、它不复制 Fun，它链接 Fun

仓库里没有解释器。`funide.dpr` 和 `ide.pas` 直接链到隔壁 `fun` 项目的源码上：

```pascal
pcrd in '..\..\regex\pcre\pcrd.pas'   // 来自 fun 项目
pcre in '..\..\regex\pcre\pcre.pas'
```

```pascal
uses fun, base, core, host, parse, pcre, ui, io;
```

这些相对路径和单元名，只有在 IDE 层**位于 `fun` 源码树里面**时才解析得开。所以构建的第一步是 `sync-ide.bat`：把 `src/ide` 与 `src/prj/ide` 复制进 `fun` 检出的对应位置，再让 `dcc32` 去编。语言实现只存一份，IDE 存另一份，两边靠路径咬合。复制过去的文件在 `fun` 检出里是未跟踪状态，那是有意的。

还有一件事单拎出来说：IDE **不**在运行时去拉起 `fun.exe`。它把 Fun 的解析器与解释器**编进**程序里，把它们当库来驱动：`CdParser`（一个 `CParser`）把编辑器里的文本变成 AST，`CdRunner`（一个 `CEnv2`）执行它，调试器就是这两个类各自重写了几个钩子。外面那些 `Fun.exe` 启动器是另一码事，只是几个菜单项。这条线扯得开，改天单写一篇。

## 三、怎么编出一个 funide.exe

Windows 32 位 VCL 程序，Delphi 编译，两个目标：2006 是 ANSI 构建，2009 是 Unicode 构建。依赖三样第三方的，都不随仓库附带：SynEdit（编辑器控件）、VirtualTrees（树控件）、PCRE 8（正则）。

机器相关的路径全收在一个 `setenv.bat` 里，写法跟 `fun/src/prj/fun/setenv.bat` 一个样：`FUN_ROOT`、`DELPHI2006`、`SYNCEDIT`、`VST`，每个变量都带 `if not defined` 兜底，你在外面设了就听你的。

```text
cd src\prj\ide
make-2009.bat          # 或 make-2006.bat
```

编出来的 `funide.exe` 落在 `<FUN_ROOT>\fun`，跟 `fun.exe` 做个邻居。

顺带放进来的还有 `syntaxes/fun.tmLanguage.yaml`，`.fun` 文件的 TextMate 语法，`scopeName: source.fun`，拿实现里的词法（`lex.l`）、文法（`yacc.y`）和关键字表（`id.inc`）对出来的。

## 四、为什么拖到今天

Fun 是 8 月 31 日开源的，funide 的仓库也是那天建的。建了，却一直空着，内容压了整整一个月才推上来。

这一个月里上游改了 134 次提交，Linux 移植、退出码、严格 JSON，一样一样补齐。理由也简单：代码是给人看的。语言刚开源那几周接口还在动，IDE 跟着一起动，这时候放出来，等于让第一批读代码的人对着流沙做笔记。等接口稳了，再一并交出去，省得大家白读。

（吐槽：一个 IDE 藏了十几年，最后挑在开源满月这天放出来，算是给自己过个节。）

funide 眼下还是 Windows 独占，Delphi 编译，Linux 上没对应版本。源码公开之后，要把编辑器换掉、想拿 Free Pascal 试着编的，都可以自己动手了。

五千行代码，读得完。