常见问题解答 (FAQ)
什么是 Xu 编程语言?
Xu 是一门静态类型系统编程语言,采用自研原生与 WebAssembly AOT 后端。它结合所有权推断、借用检查与确定性资源释放,无需垃圾回收器,并内建协程(xu f())与类型安全通道(chan T)。
Xu 编译器是否使用了 LLVM?为什么采用自研后端?
Xu 语言是否有垃圾回收(GC)?
Xu 相比 Rust 与 Go 有哪些区别?
Xu 的编译速度与实际执行性能如何?
可复现的性能实测:60 个项目组、72 个负载变体覆盖 ARM64、x86-64 六个平台,对照 Xu、C、Rust、Go 和 Swift。横测看板展示各平台的运行耗时、CPU 时间、峰值内存与二进制体积;C、Rust 按负载选取同平台 O1–O3 的最小实测中位数。编译耗时记录在来源 CI 的原始报告中。
Xu 是否原生支持 WebAssembly (WASM)?
Xu 0.13.1 支持生成面向 WASI 运行时的 wasm32-wasi 模块。浏览器演练场使用 Xu 0.13.1 构建的解释器在客户端运行。
Xu 支持原生桌面 UI 吗?必须使用 WebView 吗?
支持,而且 WebView 是可选项。当前 Xu 0.13.1 正式 SDK 提供两种界面方式:使用 #ui/draw、#ui/layout 和 #ui/widgets 编写原生绘图与控件界面;或使用 #ui/webview 承载 HTML/CSS/JavaScript,通过请求桥接与 Xu 交互。原生控件示例不需要 HTML、CSS 或 JavaScript。
#ui 提供窗口、事件、菜单、托盘、多窗口、剪贴板和文件对话框等桌面服务。控件由 Xu 在原生 Canvas 上绘制,系统菜单与对话框使用宿主外观。入口见UI / WebView 开发指南和控件 API 与示例。
UI 有哪些控件?支持中文输入和主题吗?
SDK 包含按钮、勾选框、开关、单选、滑块、步进器、标签页、列表与选择器;Input / TextArea 支持原生文字输入会话、IME、选区及复制粘贴。还提供 Table、TreeView、Pagination、ComboBox、MultiSelect、DatePicker、TimePicker、ColorPicker,以及 Popover、Tooltip、Toast、Modal 等组件。
控件共享深色、浅色和高对比度主题,支持字体与文字缩放、密度、状态样式和局部覆盖。保留布局与 Screen 上下文可协助组织控件、焦点、事件和重绘。绘图、编辑与主题的用法见样式指南和可运行示例。
widgets.ActionDispatcher 通过类型化函数表按控件 id 和 action kind 分派语义动作;XACP ui.act 操作已注册的 Screen 后产生的动作可由应用交给同一分派器处理,见控件 API与ActionDispatcher 说明。
桌面 UI 支持哪些平台?需要安装什么?
桌面宿主覆盖 macOS、Windows 和 Linux。macOS 使用 AppKit,网页使用 WebKit;Windows 使用原生宿主,网页需要 WebView2;Linux 使用 GTK4,网页另需 WebKitGTK 6.0。构建与打包需要对应平台的宿主工具链;原生绘图与控件不要求应用嵌入 WebView。
先运行 xu doctor --desktop 检查依赖,使用 WebView 时再加 --webview。应用目录包含 xu.xun、main.xu 与应用图标,使用 xu build <AppDir> --desktop 打包;完整命令见构建指南。编译器支持某个目标不等于桌面 UI 已在该目标完成运行验收;浏览器 WASM 演练场不运行桌面 UI。范围见限制与现状。
原生 UI 目前有哪些能力边界?
现有组件覆盖常用桌面交互,仍有明确边界:Input / TextArea 是纯文本编辑器;Table 为有界数据表,排序与取数由应用处理;列表与树不提供按需构建的无界数据虚拟化。富文本、高级表格、拖拽工作区与完整辅助技术桥接仍需进一步开发。
平台文字排版、IME 与系统服务也需要在真实目标系统上验收,不能以跨平台编译通过代替交互验证。选用组件前请查看对应 API 契约和示例说明。
Xu 支持哪些编辑器?如何启用 LSP?
官方 vscode-xu 扩展支持 VS Code 与 Cursor,通过 xu lsp 启动 SDK 中的 xu-lsp 语言服务器,提供实时诊断、代码补全、跳转定义、悬停文档、符号大纲、查找引用、重命名与格式化。
其他支持 LSP 的编辑器也可配置 xu lsp 作为服务器命令,通过标准输入输出(stdin/stdout)交换 JSON-RPC 2.0 消息。通常由编辑器自动启动;可用 xu lsp --help 查看帮助。
xu get 与 xu install 有什么区别?
在已有 xu.xun 的项目根目录执行 xu get <module>@<version>,即可添加或更新指定依赖:自动修改清单中的 require:、安装源码到 vendor/ 并更新 xu.lock。请将占位符替换为真实模块与已确认发布的 SemVer 标签,不接受 @latest。官方扩展包请使用 SDK 内置包或匹配的固定源码提交,再运行 xu install。
xu install 则安装清单中已经声明的依赖。两者均支持 --offline;需要严格按现有锁文件构建时,使用 xu build . --frozen。详见模块与依赖;官方 packages 仓库提供 29 个扩展包。
如何用 xu native 集成 C 代码?
xu native 提供完整的原生模块流程:xu native compile 将 C 源码与接口元数据编译为 .a;xu native archive 为已有目标文件封装元数据;xu native pack 将不同目标的切片打包为 .xulib;xu native inspect 与 xu native extract 用于检查和提取切片。
.a 用于单目标静态库,.xulib 用于携带接口契约与多个目标切片的分发。在 macos-arm64 或 macos-x64 上,构建时可直接传入库,例如 xu build main.xu native/mylib.xulib -o app。其他目标须输出并转换 XUOBJ,再外部链接。编译 C 源码需安装相应的 C 编译工具链。参数与完整示例见原生模块与 .xulib 规范,或运行 xu native compile --help。
Xu 目前支持哪些操作系统与 CPU 芯片架构?
什么是 XACP?
XACP(Xu Agent Control Protocol)是用 xu build --xacp 和/或 --xacp-port PORT 构建的 hosted native 程序的帧控制通道。该构建会嵌入发现信息。./app --xacp-help 打印机器可读摘要,其中 capabilities 为 stdio,并标明 TCP 是否启用以及绑定地址。这取代了早先只含 help-only 的发现文本。
#xacp(src/xacp)是与传输无关的安全核心:帧与 XUN 校验、权限、会话生命周期。单独导入 #xacp 不会装上启动期控制入口。stdio 与本机回环 TCP 是 --xacp 构建插入的运行时钩子。启动器是 xu xacp,它转而执行伴生工具 xu-xacp。模式为 inspect、run、debug、record、control、attach、connect。API 已包含在正式 0.13.1 SDK 提取结果中,契约依据对应发布源码。原生会话和平台/UI 运行验收仍待验。见命令行参考、#xacp API与对应发布源码。
XACP 的 stdio 与本机回环 TCP 有什么区别?
stdio。用 --xacp-stdio 启动目标,或执行 xu xacp control <program>。会话独占 stdin 与 stdout。帧使用 XACP/1\n<N>\n,后接恰好 N 个 UTF-8 字节的纯 XUN 正文。正文换行计入,前缀不计入;没有结束分隔符。传输层去掉前缀后才调用 parse_frame,见精确字节示例。业务 main 不会运行。
本机回环 TCP。用 --xacp-port N 构建,N 为 1..65535,然后运行 <app> --xacp-tcp。进程只监听 127.0.0.1:N。另一个终端执行 xu xacp connect PORT,逐帧中继同样的请求与响应。端口 0 关闭 TCP(发现信息为 tcp: disabled (port 0)),stdio 能力仍然保留。每个已接受的连接是独立会话。连接按顺序处理;失败的对端只结束自己的会话,监听继续。stdio 会话结束时进程退出。-- 之前的第一个控制标志优先。普通启动不监听,也不读取控制 stdin。
xacp.hello 会授予什么权限?
控制会话开始时没有权限,首个请求必须是 xacp.hello,携带 id: !i 1、ver: !ver 1.0.0 和非空 nonce。宿主未设置非空 XU_XACP_TOKEN 时,允许的权限仅为 PERM_INFO(1),即使客户端提供 token 或宿主设置了 XU_XACP_ALLOW_RAW=1 也不例外。配置非空 token 后,hello 必须通过 token 提供它,并由 crypto/subtle.constant_time_compare 做常数时间比较;缺失、为空或不匹配均返回 auth_failed 并关闭会话。匹配时默认允许掩码 15,只有宿主精确设置 XU_XACP_ALLOW_RAW=1 才允许 31。可选的 permissions: !i 0..31 用于请求权限,实际授予 requested & allowed;省略时请求整个允许掩码。
development 权限是显式宿主策略,stdio 与 TCP 传输不会自动开启;进入 OPEN 后权限不可再更改,schema、帧大小、窗口与生命周期检查仍然适用。默认启用的 nonce 重放检查在认证和权限校验后执行;检测到重放时返回同一请求 id 的 nonce_replay,清除会话并断开,不进入 OPEN。成功帧含整数 id: !i 和 ok: !b true,其 data 含 state: OPEN、经路径过滤并加引号的 nonce、实际授予的整数 permissions: !i 与 permission_label:掩码 0 为 none,1 为 info,31 为 development,其余为 custom。proc.output 是否可用取决于宿主的输出捕获支持,不依赖 Screen;独占启动适配器没有注册 Screen,授权后的 UI 操作返回 not_implemented,应用调用 attach API 后注册并持续 poll Screen,UI 操作便可经 Screen marshal 处理,能力边界见下文。
xu xacp control 与 xu xacp run 有什么区别?
xu xacp run <program> -- args... 会启动程序,业务 main 会运行。工具会再插入一个 --,因此名为 --xacp-help 的业务参数不会触发发现。debug 先打印 --xacp-help,再按同样方式运行。它不是断点调试器。record 在 Unix 上流式输出最多 1 MiB 的 stdout,stderr 仍留给终端。该输出不是 XACP UI 录制,Windows 上的 record 仍不可用。inspect 执行 --xacp-help,不接受业务参数,但同样会运行目标程序。
control 启动 --xacp-stdio,继承调用方的 stdin 与 stdout,跳过业务 main,并且不接受业务参数。connect PORT 不接收程序路径,只把帧中继到 127.0.0.1:PORT。run、debug、record 的用户参数必须写在工具自己的 -- 之后。
XACP 目前有哪些安全限制?
启动器只应指向受信任的本地可执行程序。inspect 也会执行它。没有 TLS,也不能绑定 127.0.0.1 以外的地址。生成器只允许 hosted native 可执行程序:库、共享对象、测试脚手架、嵌入式目标和 --desktop 都会被拒绝。未设置非空 XU_XACP_TOKEN 时仅允许 INFO 只读访问;需要控制能力时须设置 XU_XACP_TOKEN。
独占启动适配器(--xacp-stdio、--xacp-tcp 或 xu xacp control)跳过业务 main,没有注册 Screen,授权后的 UI 操作返回 not_implemented。库函数 xacp.attach_stdio() / xacp.attach_tcp(port) 让应用 main 运行,由应用注册 Screen 并持续调用 xacp.poll;ui.tree、ui.screenshot、ui.input、ui.act、ui.record 经 Screen marshal 访问真实界面。Screen 关闭或注销后,等待中的请求返回 stale_window,后续 UI 请求返回 not_implemented。xu xacp attach <program> -- args... 以安全的 -- 参数边界启动应用,应用代码仍需调用 attach API。
按 dev 协议,已注册 Screen 时,ui.record 在单次请求内完成有界 XAR1 采样,返回 mode、records、bytes、truncated 和 payload。请求需提供正数 win 与 mode: events|frames,可选 max_bytes、max_records、duration_ms。客户端重复请求拉取后续片段;每次请求只有一个响应,不保留跨请求录制状态或续传游标。stream_required 仅保留给无 sink/采样能力的适配器,内置 Screen 采样路径不返回它。
events 目前是带 state=true 的当前 window/canvas/generation/open 状态观测,没有真实输入事件日志;采样不注入输入,也不推进应用事件循环。frames 仅返回尺寸且 redacted=true,不含像素。CLI xu xacp record 录制的是 stdout,与 ui.record 的 UI 采样不同。参数边界、截断和错误语义见 API 录制说明。
proc.output 在启用 --xacp 插桩的 64 位 POSIX 生成宿主上捕获 Xu 运行时 print / eprint 与运行时 fd-write 路径的 fd 1/2 写入,不捕获外部原生代码或子进程的写入。Windows 与未插桩构建返回 not_implemented;仅调用 attach API 不会增加输出捕获能力。
XU_XACP_WRITE_TIMEOUT_MS 默认 10000 ms,范围 1..600000;按每个完整出站帧计时,部分写入进度不续期。超时视为传输失败,不再发送帧并关闭会话:独占 stdio 非零退出,TCP 只断开该对端并继续监听;stderr 打印 xacp: write timed out after W ms,W 为配置值。Windows 管道或控制台 stdio 的写超时仅尽力生效,阻塞写入仍可能无界等待。
写超时与读侧 XU_XACP_HELLO_TIMEOUT_MS(默认 5000 ms)、XU_XACP_IDLE_TIMEOUT_MS(默认 60000 ms,0 关闭)及 attach UI 等待的 XU_XACP_REQUEST_TIMEOUT_MS(默认 5000 ms)相互独立。xu xacp connect 自身没有应用级响应截止,整体进程超时仍由调用方负责。完整契约见#xacp API与XACP 协议规格。
起步教程 · UI / WebView · 模块与依赖 · 原生模块与 .xulib 规范 · 编辑器支持 · 命令行 / XACP · #xacp API