简介：面向FPGA开发和电子设计场景，Wavedrom Editor v2.3.2 Windows 64位版是一款基于文本语法快速生成时序图的本地工具，适合需要在离线或网络受限环境下绘制信号波形的开发者。压缩包共124个文件，约83.72MB，其中pak与info文件为应用运行资源，dll与exe构成可执行主体，bin、dat及html用于启动与数据初始化，整体为免安装式绿色包结构。编辑器支持上升沿、下降沿、脉冲等波形元素，可添加注释、标签与颜色，并提供实时预览，输入语法后即时看到图形，完成后可导出SVG、PNG或嵌入网页。已有2168人学习下载，对于希望提升时序图绘制效率、替代手工画图的FPGA工程师和电子爱好者，这份资源可直接解压运行，上手门槛低，能减少重复绘图工作并规范文档输出。
1. 时序图绘制为什么值得单独用一个编辑器
做数字逻辑、接口调试或者写芯片驱动的时候，最头疼的往往不是代码本身，而是怎么把时序讲清楚。早年我用 Visio 画信号波形，一个 8 位并行接口的画下来要拖半个小时，改一个时钟周期又得重排半天，后来换成在线版 WaveDrom 才解脱。在线版虽然方便，但总有断网、打不开或者多人协作时同步不过来的情况，于是就有了这个打包好的桌面版——wavedrom-editor-v2.3.2-win-x64.zip。它本质上是把 WaveDrom 引擎和编辑器界面封进了一个免安装的 Windows 程序，打开即用，波形图保存成 SVG 矢量图给文档、PPT、论文用都足够清晰。
这个工具解决的核心问题是时序图绘制的效率：用 JSON 描述信号，用文本驱动图形，改一个参数整张图跟着变。适合做芯片验证、嵌入式开发、FPGA 调试的工程师，也是做技术文档时快速出时序图的实用助手。文本即图形，意味着图可以进 Git，可以 diff，可以版本回溯，这可比一张 PNG 实用得多。
2. 安装与启动：解压、改配置、双 MDI 模式
2.1 环境确认和目录结构
拿到 wavedrom-editor-v2.3.2-win-x64.zip 之后，先不要急着双击 exe。这个版本是 Electron 打包的，v2 的渲染引擎是 WaveDrom 2.x 内核，跟在线版的功能基本对齐。解压后你会看到以下几个关键部分：
wavedrom-editor-v2.3.2-win-x64/ ├── WaveDromEditor.exe ├── resources/ │ └── app.asar # 主程序打包文件 ├── locales/ # Electron 多语言文件 └── *.dll # 运行库这里注意，整个目录必须保持在同一个文件夹下，不能只拷贝 exe 出来单独运行，否则启动会直接报错。常见做法是先把整个压缩包解压到一个无中文、无空格的路径，比如 D:\Tools\WaveDromEditor。
启动方式就是你熟悉的双击 exe。首次打开时如果 Windows SmartScreen 弹提示，那是因为没有代码签名证书，属于 Electron 应用的常规情况，选择“仍要运行”就行。实际使用过程中我没遇到什么运行库缺失的问题，因为 Electron 已经把这些依赖都打进去了。
2.2 编辑器界面和双 MDI 模式
装好之后你会看到主界面分成左右两栏：左边是 Source 编辑区，右边是 WaveDrom 渲染预览区。这个布局其实很有用——左边写 JSON，右边实时出图，不需要手动刷新。跟在线版唯一的区别是，它同时支持把多个波形图组织在一个工程里，用左侧的标签页切换。
值得说的是这个版本默认的皮肤配置。WaveDrom 支持的皮肤不止一种默认样式，在 v2.x 里内置了default和narrow两种。皮肤切换不通过界面按钮，而是在 JSON 里写入配置项。比如你在 Source 区最前面加这么一段：
{ "skin": "narrow" }加了之后，右侧预览会立刻变化：信号线的间距、字体大小都会缩小，适合紧凑排版。如果你要画一个有很多信号的图，窄皮肤能压缩不少篇幅。
启动之后如果你觉得默认字体渲染有锯齿，可以通过编辑器的内置设置微调缩放。Electron 应用一般跟随系统缩放，如果屏幕是 4K 或者 150% 缩放，建议在系统设置里调整显示缩放比例到 100%，这样 WaveDrom 输出的 SVG 在后续导入 Word 或 PPT 时不会产生模糊。
2.3 命令行启动和文件关联
除了双击打开，这个编辑器还支持通过命令行直接加载.wavedrom文件。.wavedrom就是纯 JSON 文件，扩展名不同而已。用命令行方式的好处是可以写成脚本批处理，比如从 CI 里直接触发预览：
cd /d D:\Tools\WaveDromEditor start WaveDromEditor.exe d:\specs\spi_timing.wavedrom这个命令的意思是：进入程序目录，用start启动编辑器并传入时序图文件的绝对路径。注意这里要用绝对路径，相对路径在某些场景下解析会失败。程序支持多开，多次执行会打开多个编辑器窗口，不会复用已有实例。
如果你希望双击.wavedrom文件就能直接打开，可以在 Windows 里右键文件 → 打开方式 → 选择 WaveDromEditor.exe，并勾选“始终使用此应用打开”。不过我一般不建议这么做，因为日常编辑文档时还要靠 JSON 做版本管理，最好还是用 IDE 打开 JSON，只有需要渲染预览时才开编辑器。
3. WaveJSON 核心语法：从基础波形到组合信号
3.1 signal 与 wave 的映射关系
WaveDrom 的时序图完全由 JSON 数据驱动，这是它区别于手绘工具的核心点。你不需要关心坐标轴，不用拖线条，只需要描述每个信号在某个时刻的状态。Signal 数组是整张图的骨架，每个元素可以是字符串（信号组标题），也可以是对象（信号定义）。
对象里最关键的字段是wave，它是一串字符，每个字符代表一个时钟周期。比如：
{ "name": "clk", "wave": "p........." }p表示一个时钟脉冲（上升沿加下降沿），.表示保持上一状态。这段代码会让编辑器的预览区出现一个周期为 8 格的时钟信号。注意p占一格，但你在实际波形图上会看到它占用一格宽度并在下一格开始前完成跳变。
这里的每个字符都对应一个时间片，有几个字符就有几个周期。如果你想要连续几个脉冲，可以写成p.p.p.p.。p是正脉冲专用字符，从低到高再到低。如果想要反相时钟，可以用n，表示负脉冲，从高到低再到高。
{ "name": "clk", "wave": "p.p.p.p." }, { "name": "rst_n", "wave": "0.1......." }第二行里0代表低电平，1代表高电平。rst_n 初始为低，然后第二个周期跳高并保持。这种写法直接把时序逻辑里最常见的复位释放场景表达出来了。
3.2 data 总线与 hex 数据标注
画数据总线是 WaveDrom 最顺手的地方。普通信号用高低电平，数据总线则往data字段里填数组，数组元素与wave中的每个周期对齐。为了可读性，通常wave用x表示不定态，用=表示有效数据周期：
{ "name": "addr", "wave": "x=====x", "data": ["0x00", "0x04", "0x08", "0x0C", "0x10"] }这里x是未知态，=是有效数据。data数组长度应该和=的个数严格对应，一共 5 个=，就要给 5 个数据。如果个数不匹配，渲染时会按从左往右的次序显示，多余的会被忽略，少了的则会空白，这个坑后面细说。
数据还可以用h表示半字节高位、l表示半字节低位，但在大多数只需要展示十六进制数值的场景里，x加=的组合最实用。如果你的数据是字符串型的 ID 或命令字，直接在data数组里写字符串也没问题，编辑器会自动渲染成文本形式。
3.3 组合逻辑与多信号对齐
时序图绘制最核心的操作就是让多个信号在时间上对齐。WaveDrom 的做法是：所有信号的 wave 字符串等长，每一个字符代表同一个周期索引。你把信号竖向排列，横向对齐关系一目了然。下面这段描述了一个典型的 SPI 读操作：
{ "name": "sclk", "wave": "p.p.p.p.p.p.p.p." }, { "name": "cs_n", "wave": "1...............0" }, { "name": "mosi", "wave": "x.=.=.=.=.=.=.=.x", "data": ["1", "0", "1", "0", "1", "0", "1", "0"] }, { "name": "miso", "wave": "x.=.=.=.=.=.=.=.x", "data": ["A", "B", "C", "D", "E", "F", "G", "H"] }这个例子中cs_n拉低期间正好覆盖 8 个时钟脉冲从无效到有效的区间，而 mosi 和 miso 上的每一位数据与时钟上升沿对齐。sclk的 count 是 9 个脉冲？不对，这里写的是p.p.p.p.p.p.p.p.，一共 8 个p加 8 个点，共 16 个时间片。cs_n 的 wave 是 1 后面 15 个点加 0，也对应 16 个周期，长度才能对齐。
对齐原则给新手提个建议：写之前先在纸上把周期总数算明白，再对照着填字符。常见翻车现场就是一个信号多了或少了一个字符，然后整张图的信号全部错位，你还在那里以为是电平画错了。
4. 导出与文档集成：SVG、PNG 与脚本化输出
4.1 编辑器导出和清晰度选择
波形图画好之后，导出是第一诉求。WaveDrom Editor 内置的导出按钮在工具栏右侧，支持 SVG 和 PNG 两种格式。SVG 是矢量图，直接放进文档里放大不糊，我一般都是导 SVG。PNG 也可以，但要注意编辑器的默认导出分辨率不算高，如果放到印刷文档里需要调大像素倍率。
具体操作为：先确定预览图已调整到合适的缩放比例，然后 File → Export → SVG 或 PNG。导出 PNG 时如果觉得字太小，可以在 JSON 里临时加一行配置来放大字体：
{ "config": { "fontsize": 14 } }fontsize的默认值是 12，放到 PPT 或网页里建议调大到 14 以上，导出后再删掉这行配置不影响源文件。
4.2 用命令行和 Node 脚本批量导出
如果你有批量生成时序图的需求，比如要给一整个接口文档出图，可以不用打开编辑器手工导出，直接用命令行调用 WaveDrom CLI 或写 Node 脚本。这个 zip 包自带的编辑器内置了 Node 运行时，但 CLI 工具没有单独暴露出来。实际工程里更常见的做法是安装独立的 wavedrom CLI：
npm install -g wavedrom-cli wavedrom-cli -i input.json -o output.svg这条命令的含义是：从input.json读取源码，渲染并输出到output.svg。如果你的环境里没有 Node，也可以直接打开编辑器手动导出，效果一致。CLI 的缺点是不带预览，适合做批处理，其中 JSON 里如果没有指定skin，则使用默认皮肤，跟编辑器预览一致。
还有一种更稳的方式：直接把 JSON 文件拖进浏览器，用在线版渲染。但桌面版的优势就是完全离线可用，渲染引擎在本地，所以无论软件环境多封闭，都不影响你出图。
4.3 嵌入 Markdown 和 Word
SVG 进 Markdown 是工业界最顺滑的组合。你只需要把导出的 SVG 文件放到文档同级目录，然后引用：
在某些 Markdown 渲染器里直接嵌 SVG 可能不显示，这是平台限制不是图片问题。遇到这种情况可以用 PNG 代替，或者把 SVG 内容直接粘贴到 HTML 文件里。
Word 这边稍微有点讲究：默认粘贴 SVG 进来时，Word 会强制按屏幕分辨率渲染，导致缩放后边缘略糊。我的习惯是在 Illustrator 或 Inkscape 里把 SVG 转成 EMF 再粘贴。如果没有装这类软件，直接粘贴 PNG 反而是个省心选择，Word 对 PNG 的缩放抗锯齿优于 SVG。
5. 避坑指南：WaveDrom 编辑器常见问题排查
5.1 JSON 解析失败，预览区一片空白
现象：左侧写的 JSON 明明是对的，右侧预览什么都不显示，控制台也没有报错。
原因：这大概率是 JSON 格式的问题，最常见的是最后一个对象后面多了一个逗号。JSON 不允许尾逗号，而写编辑器代码时习惯性会留一个。
解决：养成写完一个 field 就回头扫一眼的习惯。如果实在找不出问题，把内容全部复制到任意一个 JSON 校验工具里查。编辑器本身没有专门的错误提示弹窗，这是它体验上不够友好的地方。另外检查一下是不是用了中文引号，字符串必须用英文双引号包裹。
5.2 波形字符长度不一致，信号错位
现象：画一个 AXI 读通道时序，两个信号看起来长度差不多，但一个信号从第三个周期开始就跟另一个错位了。
原因：wave 字符串长度不相等，或者 data 数组里某个元素多了一个空格导致渲染移位。
解决：先把所有 wave 字符串按最长的一条对齐，不足的补.。千万别用空格补位，JSON 里的字符串本身会忽略尾部空格，但中间的空格会被解释成字符，直接用.才是有效占位。至于 data 数组里的文本内容，检查是否有多余空格、全角字符、转义符，都会导致渲染差异。
5.3 skin 配置不生效
现象：在 JSON 开头写{ "skin": "narrow" }，预览完全没有变化。
原因：skin 配置的层级不对。WaveDrom 要求skin是顶层键，不能放在 signal 数组内部，也不能放进 config 里。
解决：如果你在编辑器里照抄了一段网上代码，先把skin移到最外层，再确认拼写是"narrow"不是"narrow "。如果你用的是 v2.3.2 版本，它支持的皮肤列表只有default和narrow，网上有些教程提到"lowkey"皮肤，那是更高版本或第三方皮肤，这个版本用不了。
5.4 导出 PNG 文字发虚
现象：导出 PNG 后，放大看文字边缘有锯齿，尤其信号名和数值。
原因：编辑器默认导出用的缩放倍率是 1x，对于高分辨率屏幕或文档插图来说不够。
解决：导出之前，在 JSON 里加上"config": { "hscale": 2 }。hscale是水平缩放系数，设成 2 可以让矢量化文字在导出时获得 2 倍分辨率。注意它也会加宽每个时间片的像素宽度，图会变宽，但清晰度优先。如果你不需要加宽，只想提高渲染像素，可以结合fontsize和导出后手动缩放。
5.5 打开 exe 报缺少 DLL
现象：双击 WaveDromEditor.exe 报VCRUNTIME140.dll 缺失或类似错误。
原因：Electron 应用有时候依赖 VC++ 运行库，某些精简版系统没预装。
解决：下载并安装微软官方 VC++ 运行库合集（2015-2022 x64），装完重启编辑器。这不是这个工具的 bug，是 Windows 环境问题。装好之后所有 Electron 应用都能受益。
6. 进阶技巧：用 edge、phase 和 reg 标注提升时序图专业度
时序图画到能看只是及格，能直接拿去评审才叫专业。WaveDrom 里最容易被忽视的进阶能力是edge标注和phase控制。edge可以在波形上标注上升沿或下降沿的箭头和文本，用来描述触发条件。比如：
{ "name": "clk", "wave": "p......", "edge": "a..b.." }这里a在第一个上升沿打一个箭头标注，b在第二个上升沿打另一个。edge的字符长度必须和 wave 对齐。配合node配置可以给这些边沿命名：
{ "node": "A.B" }注意这里点语法：A表示第一个节点，.B表示第二个节点，node中的字符顺序跟edge的 a、b、c 对应。然后再从头部的文本区添加 phase 标注，比如在 JSON 顶层加：
{ "phase": 0.5 }phase会把整个波形往右平移半个时间片，这在画源同步接口时非常有用——输出数据相对于时钟的延迟一目了然。做 DDR 接口的朋友可以试试调节这个参数来看 DQS 与 DQ 的相位关系。
再讲一个我常用的reg标注。在信号对象里加"reg": [["write", "0x34"]]，它会在波形旁边生成一个带触发条件的寄存器注释块。这个功能在画状态机跳转或者寄存器读写时序时特别直观，评审时不用你多解释，看图就懂。
用arrow表示跨信号依赖关系也是制胜技巧：
{ "name": "req", "wave": "0.1....0." }, { "name": "ack", "wave": "0...1..0." }在两个信号之间手动标注因果关系，需要借助编辑器里的连线工具——但实际上 WaveDrom 的 JSON 并不直接支持任意箭头连线。真实做法是导出 SVG 后用矢量编辑器补一条箭头线，或者改用上面说的edge节点在单个信号上做触发说明。不要强求工具做它设计之外的事，这是 WaveDrom 的边界之一。
每张图出完之后，我会做一次强制检查：wave 总长度是否一致、data 元素数量是否与=对应、edge与 wave 是否等长、phase 是否影响了对齐关系、hscale是否调过。这五步走完，图基本挑不出大毛病。从那以后我每次写接口文档都强制走一遍这个流程，翻车率直线下降。希望这份笔记帮到你。
本文还有配套的精品资源，点击获取
