Delphi+Sciter混合布局
原创 舞动的代码 2026-11-15 19:58 广东

这是一篇杂记
之前有一份远程办公的工作,大概 7 月份截止了。然后应一个粉丝的邀请,来了东莞做软件开发。
接手之后干的第一件事不是写代码,而是推翻了自己原来的方案——这篇就把这几个月踩的路子完整交代一遍,顺便聊聊为什么我把写界面的方式,从 VCL 换成了 Web。
VCL 重绘:一颗圆角按钮的代价
先说痛点。东莞这个项目,打开原有的界面一看:控件是自定义的,需求很朴素——按钮不要系统给的那个直角,要圆角。
在浏览器里,这句话对应一行 CSS:
.btn {
border-radius: 8px;
background: #2b7fff;
color: #fff;
transition: background .15s ease;
}
.btn:hover { background: #1f6ae0; }
.btn:disabled { opacity: .5; }在 VCL 里,它对应的是这么一段——GDI+ 手工描路径、自己填色:
uses GDIPAPI, GDIPOBJ, GDIPUTIL;
procedure TForm1.PaintRoundBtn(const R: TRect; Radius: Integer; AFill: TColor);
var
G: TGPGraphics;
Path: TGPGraphicsPath;
Brush: TGPSolidBrush;
Pen: TGPPen;
begin
G := TGPGraphics.Create(Canvas.Handle);
try
G.SetSmoothingMode(SmoothingModeAntiAlias);
Path := TGPGraphicsPath.Create;
try
Path.AddArc(R.Left, R.Top, Radius * 2, Radius * 2, 180, 90);
Path.AddArc(R.Right - Radius*2, R.Top, Radius * 2, Radius * 2, 270, 90);
Path.AddArc(R.Right - Radius*2, R.Bottom - Radius*2, Radius * 2, Radius * 2, 0, 90);
Path.AddArc(R.Left, R.Bottom - Radius*2, Radius * 2, Radius * 2, 90, 90);
Path.CloseFigure;
Brush := TGPSolidBrush.Create(ColorRefToARGB(ColorToRGB(AFill)));
try
G.FillPath(Brush, Path);
finally
Brush.Free;
end;
Pen := TGPPen.Create(ColorRefToARGB(ColorToRGB(clGray)), 1);
try
G.DrawPath(Pen, Path);
finally
Pen.Free;
end;
finally
Path.Free;
end;
finally
G.Free;
end;
end;这段只解决了"画出来"的问题。真正做下去,你还得自己补:
• 四种状态:悬停、按下、禁用、键盘焦点,每种都要再来一遍配色;
• DPI 缩放:125% / 150% 下半径和线宽要跟着变,否则放大后就是一圈毛边;
• 边缘混色:抗锯齿的边跟父窗口背景混不上,深色主题下会露出灰边;
• 细节接管:owner-draw 之后,文本居中、快捷键下划线、焦点框全归你管。
当然还有更省事的路:上 VCL Styles。但你得去做一套 vsf 皮肤,而且第三方控件不一定遵循它,最后还是得手工补一半。
一圈折腾下来,一行 CSS 的事,在 VCL 里小半天就没了。
这不是 VCL 的错。它诞生于 1995 年,"像素级定制"从来不在它的设计目标里。既然这次的需求就是像素级定制,那就该换个画法:界面用 Web 技术写,Delphi 只负责套壳。
Delphi + Sciter
套壳的路子,Delphi 圈里常见三种:
• WebView2:依赖系统里的 Edge 运行时,Win11 自带没问题,Win10 得额外装。客户端一装完点不开就是事故,而且和 Delphi 的交互要走 JS 桥,回调一多就很啰嗦。
• CEF4Delphi:功能最全,我早年也折腾过。但 libcef 一打包就是上百 MB,目录里一堆 dll、pak、locales,升级还得跟着 Chromium 的版本走。
• Sciter:经群里的小宝软件(QQ 305230354)提醒我才知道。一句话概括——把 HTML/CSS 渲染引擎直接做进一个 5MB 左右的 DLL,没有 Chromium 那一大坨依赖,界面资源还能编译进 exe。
用了一阵子,说说真实感受。
优点:
1. 体积小得离谱。 官方给的数字是单 DLL 5+ MB,一个 hello world 打包出来的 scapp.exe 也就十四 MB 上下。同样的事用 Electron 做,起步一百多兆。
2. 原生窗口是真的原生。
<window>元素可以创建真正的系统窗口、真正的模态对话框、系统托盘、独立弹窗,而不是浏览器里那种 DOM 模拟的"假弹层"。这一点对桌面软件太关键了。3. 排版能力给得足。 flex、grid、圆角、阴影、过渡动画、
position: sticky都在,前端那套手感能直接搬过来。4. 自带调试器。 用官方那个 sciter.exe 打开你的 HTML,就是所见即所得 + 类 DevTools 的 inspector,改 CSS 立刻生效,连 Delphi 都不用重编。
5. 脚本层可选。 老版本用自家的 TIScript,新的 Sciter.JS 用标准 ES6。两者共用同一套 HTML/CSS 内核,差别主要在脚本和 DOM 胶水层。新项目直接上 Sciter.JS 就行。
缺点也得说清楚,不然就成软文了:
1. 生态小。 npm 上那一整套不能直接用,依赖 Node API 的库基本告别,UI 组件库也不是开箱即用。
2. DOM API 和浏览器不完全一样。 Sciter 把 DOM 简化成 Element / Node 两个对象,写惯浏览器那套的人会先愣一下;Vue / React 得自己找适配,别指望原样跑。
3. CSS 有出入。 大部分特性都在,但滚动条、部分伪类、
dip单位这些细节跟浏览器不一致,抄现成样式时要注意。4. 要花钱。 Sciter 不是白嫖的,Indie 版一次性 1620,做商业软件前先看清楚条款。
5. 国内教程基本等于没有。 中文资料主要靠社区零散的博客和翻译手册;Delphi 侧的封装库 sciter4d 还停在 sciter3,遇到坑只能翻官网文档和英文论坛。
总结成一句话:如果你的界面是"表单 + 列表 + 自定义皮肤",Sciter 的性价比高得离谱;如果要做浏览器级别的重活,老老实实上 CEF。

软件(码农宝盒)重构
选型定了,第一刀没砍东莞那个项目,而是砍我自己的软件——码农宝盒。理由很简单:拿别人的项目练新框架,出问题要赔钱;拿自己的练,出问题顶多交学费。
简单介绍一下这个软件:它是个资源盒子。左侧是一列 VCL 画的图标导航,右侧整块都是页面。
• 待办:就是第一个图标指向的页面;
• 网盘:集成 openlist(AList 那套的社区分支),把各种网盘统一到一个入口;
• 社区:其实只是个简单的网址入口,套的是纷传的登录页。
顺便把本地浏览器收藏夹的功能移除了——用的人不多,维护成本却一点不低。
这次重构,右侧的页面全部改成 HTML/CSS,左侧导航保留 VCL。两边通过 Sciter 的事件接口通信:Delphi 管窗口、托盘、文件、注册表这些"重活",Web 管界面和交互。真正踩坑最多的是两处:DPI 缩放下的界面比例,和自定义标题栏的拖拽热区。这两块我打算单独写一篇,坑多到能写满一整期。
上面那张截图就是重构后的样子:左边四个图标是 VCL,右边整个列表和那个"设置 / 关于"窗口,全是 HTML 画的。
AI 的选择
选 Web 还有一条不那么技术、但对我影响最大的原因:AI 的语料分布。
Delphi 的 VCL 自绘、GDI+、消息循环这堆东西,网上的资料大多是十几年前的博客、论坛帖和企业内网;而 Web 前端是全互联网语料最密集的地方。同一个需求丢给模型,CSS 那份基本一次成型,VCL 那份却经常给你编 API——方法名有,参数没有,改三轮才能编译过。
这不是小事。当开发方式变成"人描述、AI 写代码"之后,语料浓度就是隐性成本。
再说工具链。
• Claude Code:生成质量确实还是第一档,但贵。跑长任务的时候,token 烧得让人心疼。
• Codex(我用的是 GPT6.5 Sol):稳,但运行过程不可见。你得等它跑完才知道它到底改了哪儿,出了问题连现场都找不着。
• OpenCode:我最早折腾的就是它,好处是能接很多家模型,坏处是免费模型要么经常失效,要么额度根本不够用。
最后找到了 Pi。最对我胃口的一点是:不绑模型。它既能接 Codex,也能接 Claude Code,还能接入各种自定义 provider——哪家的额度用在哪种活上,自己说了算。我现在跑在 Windows 的子系统模式(WSL)里,敲的是 ls / rg / git 这套 Unix 命令,改的却是挂在 /mnt/e 上的 Delphi 工程,两边互不打扰。
至于模型,6-7 月份的时候 deepseek 还不能干活,现在完全可以了,我主力就是它;复杂一点的界面重构会拆成子任务并行丢出去,自己只做评审和收尾。

最后
写这篇的时候,Sciter 版的码农宝盒已经能日常使用了(盒子的链接:https://pan.baidu.com/s/1qNVLoap6v2SIOf2pi26Edw?pwd=myw1 )。 VCL 依然是 Delphi 最稳的那一块,但它擅长的从来不是画皮肤。
接下来我可能会规划一套Delphi+Sciter的课程,大纲(讲义)已经列出来了,课程只是发布在社区,毕竟大家进了社区不能和没进一样吧。
本文转载自微信公众号「Delphi研习社」,查看原文。版权归原作者所有,如有侵权请联系删除。