Apache Tcl 介绍与选型指南

一、信息基准

1.1 项目形态与版本口径

• 查询日期：2026-10-18，全部信息以当日官方公开数据为准。
• 项目形态：Apache Tcl 是 Tcl 语言与 Apache HTTP Server 集成的项目群（官网自述），无统一版号，本篇按「组件-版本基准表」逐列给出。
• 子项目构成（官网导航与 Apache 项目目录收录）：Apache Rivet（活跃开发）、Apache Websh（已停止开发）、mod_tcl（已停止开发）。
• 退役说明：ASF 官方项目目录仍收录 tcl-rivet 与 tcl-websh 条目且无退役标记，Apache Attic 未收录本系列；但 Websh 与 mod_tcl 在各自官网明确声明因资源不足停止支持与开发，本篇如实标注，选型对比章明确不建议新项目采用这两个子项目。

1.2 组件-版本基准表

1.3 官方来源清单

二、软件概述

2.1 项目定位

Apache Tcl 官网自述：该项目是 Tcl 与 Apache HTTP Web Server 集成工作的家园，目标是把 Apache Web 服务器的力量与成熟、健壮、灵活的 Tcl 脚本语言能力结合起来。项目群包含 Rivet、Websh 与 mod_tcl 三个子项目，其中官网明确「我们目前开发并支持 Apache Rivet」。

2.2 现状概述

本篇以当前唯一活跃的子项目 Apache Rivet 3.3.1 为主要介绍对象：mod_rivet 作为 httpd 的内容生成模块运行 Tcl 脚本与 Rivet 模板，Rivet 模板的书写方式类似 PHP 页面（官网口径）。Rivet 3.3.x 官方声明为首批正式支持 Tcl 9.0 与 Tcl 8.6 的发布系列。开源许可为 Apache-2.0（ASF 项目）；GitHub 上未托管官方仓库副本，stars 官方未公布。

三、核心架构与核心概念

3.1 mod_rivet 模块

Rivet 以 Apache httpd 模块（mod_rivet）形式运行：httpd 收到对 .rvt/.tcl 资源的请求后，由模块加载 Tcl 解释器执行页面脚本并回写响应内容（官网 About 与 Hello World 教程口径）。

3.2 Rivet 模板（.rvt）

模板即 HTML 中内嵌 Tcl 代码：使用 <? ... ?> 标签执行语句、<?= ... ?> 缩写输出字符串（官网注明 2.0.5 起支持缩写形式）；页面级命令空间为 ::rivet::（如 ::rivet::html、::rivet::upload、::rivet::cookie）。

3.3 执行语义约定

3.3.1 发行注记明确：.tcl 脚本按 Rivet 契约在全局命名空间求值，这是升级 Tcl 9 兼容修复时的关键语义点。

四、功能特性

4.1 Tcl 9 与 8.6 双线支持

3.3.0 为首批官方支持 Tcl 9.0 与 Tcl 8.6 的发布系列；3.3.1 延续该兼容性并修复 upload 命令与 Tcl 9 的不兼容缺陷（官方发行注记口径）。

4.2 Web 常用能力内建

官方文档与发行注记可见的能力包括：::rivet::html 辅助生成 HTML 元素、::rivet::upload 处理上传、::rivet::cookie 处理 Cookie（含取值分隔符解析）、二进制输出命令 ::rivet::write_binary 与 ::rivet::with_binary_output（3.3.0 新增）。

4.3 多渠道发行

官方下载页给出的获取渠道：ASF 目录（www.apache.org/dyn/closer.lua/tcl/rivet）、OpenSUSE 发行版包、Debian/Ubuntu 的 libapache2-mod-rivet 包、FreeBSD 的 www/mod_rivet port。

五、快速上手（引自官方教程，未做本地实测）

5.1 官方 Hello World 示例

以下内容引自官方 Hello World 教程（来源：https://tcl.apache.org/rivet/html/hello_world.html ，Apache-2.0 许可）。在 Apache 配置正确的目录下创建 hello.rvt，内容如下：

<html>
<head>
<title>Hello World</title>
</head>
<body>
<pre>
<b><? puts "Hello world" ?></b>
</pre>
</body>
</html>

5.2 进阶写法

官方教程随后给出变量与 html 命令的用法，以及 2.0.5 起支持的输出缩写：

<? set hello_message "Hello world" ?>
<html>
<head>
<title><? puts $hello_message ?></title>
</head>
<body><?
puts [::rivet::html $hello_message pre b]
?></body>
</html>

六、适用场景与限制

6.1 适用场景

• 企业内部沉淀大量 Tcl 代码资产、希望直接在 httpd 上以脚本页形式提供 Web 界面的存量系统。
• 与 Apache httpd 深度绑定、需求简单的动态页面或内部工具页。
• 以 Rivet 3.3.1 为准的新集成需绑定 Tcl 8.6 或 9.0 运行时。

6.2 限制

• Websh 与 mod_tcl 已停止开发并关闭讨论列表（官网声明），不建议新项目采用。
• 项目群整体社区规模小、版本节奏慢，Rivet 3.3.x 之后的路线依赖社区投入。
• 与现代前端工程化、异步生态缺乏官方集成材料；选型前应确认团队能长期自持维护。

七、同类选型对比

7.1 量化对比（2026-10-18 联网实查，嵌入脚本视角）

数据来源：tcl.apache.org（Rivet 版本与状态）、GitHub 仓库页与 releases.atom（lua/lua、python/cpython）；stars 为 2026-10-18 实查值，Apache Tcl 无官方 GitHub 仓库故记为官方未公布。

7.2 选型建议

已有 Tcl 资产且坚持 httpd 内嵌脚本形态的存量系统可选 Rivet 3.3.1 延续维护；通用的语言级嵌入或新项目应优先考虑 Lua（轻量嵌入）或 Python（生态完备），并避免采用已停止开发的 Websh 与 mod_tcl。

八、参考链接

• Apache Tcl 官网：https://tcl.apache.org/
• Apache Rivet：https://tcl.apache.org/rivet/
• Rivet 3.3.1 发行注记：https://tcl.apache.org/rivet/html/release-notes.html
• Rivet 下载页：https://tcl.apache.org/rivet/html/download.html
• Hello World 教程：https://tcl.apache.org/rivet/html/hello_world.html
• Websh 官网（停止开发声明）：https://tcl.apache.org/websh/
• mod_tcl 官网（停止开发声明）：https://tcl.apache.org/mod_tcl/