企业官网建设流程全解析

WezTerm插件指南：从零到可用的终端插件安装与开发实操

【免费下载链接】weztermA GPU-accelerated cross-platform terminal emulator and multiplexer written by @wez and implemented in Rust项目地址: https://gitcode.com/GitHub_Trending/we/wezterm

WezTerm是一款用Rust实现的GPU加速跨平台终端模拟器和多路复用器，配置全部用Lua完成。它的插件系统就是把一段Lua代码打包进Git仓库，让WezTerm拉取后自动挂到配置构建流程上，帮你扩展内置配置覆盖不到的功能。

你的终端还差什么？

你的终端还差什么？先想三个场景：你切了几十个标签页，想按编号快速跳转，只能靠Cmd+W一个关一个；你希望右上角状态栏同时显示当前时间、电池和当前目录，翻遍配置文件只能找到一行status_update_interval，却凑不出想要的组合；你每次换台机器都要手抄一遍配色、字体和快捷键，配置散落各处没法复用。

这些活儿用WezTerm插件都能收进一个可分发的Git仓库里，改一次、到处同步。

三步把插件跑起来

1. 引入插件。在你的~/.wezterm.lua（macOS/Linux）或wezterm.lua（Windows）里，用wezterm.plugin.require传入插件仓库地址。只支持HTTPS或本地file协议的Git仓库。

2. 应用插件配置。插件仓库里的plugin/init.lua会导出一个apply_to_config函数，把config builder传进去，插件就把它的改动挂到配置上：

local wezterm = require 'wezterm' local a_plugin = wezterm.plugin.require 'https://example.com/owner/repo' local config = wezterm.config_builder() a_plugin.apply_to_config(config) -- 插件把改动写进配置 return config

3. 验证与更新。插件首次引用时会被克隆到运行时目录的plugins/NAME下；之后仓库有新提交时它不会自动跟随更新，需要手动拉取。可以在DebugOverlay的Lua REPL里执行wezterm.plugin.update_all()，再执行wezterm.reload_configuration()让新代码生效。

从零捏一个状态栏插件

把下面四步当成一个迷你项目串起来走。先在本地建好目录结构：

mkdir -p status-plugin/plugin cd status-plugin && git init

然后在plugin/init.lua里写一个最小插件：它必须返回一个带apply_to_config函数的模块。这个插件设置状态栏刷新间隔，并在每次update-status事件时往右侧状态区写当前时间：

local wezterm = require 'wezterm' local plugin = {} function plugin.apply_to_config(config, opts) opts = opts or {} -- 状态栏每1秒触发一次事件 config.status_update_interval = opts.interval or 1000 -- 时间格式可被配置覆盖，默认只显示时分 local fmt = opts.time_format or '%H:%M' wezterm.on('update-status', function(window, pane) -- 把格式化后的时间写进标签栏右侧 window:set_right_status(wezterm.strftime(fmt)) end) end return plugin

回到配置文件，用file://协议指向本地目录加载它，并传入自定义参数：

local wezterm = require 'wezterm' local status = wezterm.plugin.require 'file:///home/you/projects/status-plugin' local config = wezterm.config_builder() status.apply_to_config(config, { interval = 2000, time_format = '%a %H:%M' }) return config

保存配置后WezTerm会热重载，两秒一次的Mon 14:32就会出现在标签栏右侧。改了init.lua里的逻辑后，记得在Lua REPL里跑wezterm.plugin.update_all()把改动同步进运行时目录，再wezterm.reload_configuration()——本地插件的更新同样不走自动通道。想加更多列（目录、电池），就照着window:set_right_status的文档往元素表里加，配色和字体都能用wezterm.format控制。

踩过的坑和容易忽略的细节

• 🚫 加载失败先查两处：wezterm.plugin.require的URL必须是HTTPS或file协议，地址写错协议会直接报错；再用wezterm.plugin.list()看它到底落在运行时目录哪个位置。
• 🚫 多个插件都改同一个配置项时，按apply_to_config的调用顺序生效，后调用的会覆盖先调用的，排错时把调用顺序对一遍。
• 🚫update_all()只拉代码不重载配置，官方文档明确提醒要手动再执行wezterm.reload_configuration()，少一步就会怀疑人生。
• 🚫 配置文件默认开启热重载（automatically_reload_config为true），但别在配置文件的顶层直接调reload_configuration()，官方文档原话：那会造成无限循环让WezTerm无响应，只该在事件或定时器回调里调。
• 🚫 本地开发默认按仓库默认分支（一般是main）取代码，你在别的分支上改了东西，WezTerm看到的还是main，测试前先切回默认分支。

往哪走

插件机制的完整说明在仓库里的plugins.md，配置项逐个有文档，建议对着update-status事件文档把状态栏那套API摸熟。社区插件列表可以搜awesome-wezterm，里面按场景分好了主题、状态栏、工作区管理这几类。下一步就做一件小事：给上面那个状态栏插件加一个电池百分比列——wezterm.battery_info()返回每个电池的电量，套进set_right_status里，十分钟的事。

【免费下载链接】weztermA GPU-accelerated cross-platform terminal emulator and multiplexer written by @wez and implemented in Rust项目地址: https://gitcode.com/GitHub_Trending/we/wezterm