用 CircuitJS1 Desktop Mod 把电路从纸面搬到屏幕：一份零成本离线仿真实战指南

用 CircuitJS1 Desktop Mod 把电路从纸面搬到屏幕：一份零成本离线仿真实战指南

【免费下载链接】circuitjs1Standalone (offline) version of the Circuit Simulator with small modifications based on modified NW.js.项目地址: https://gitcode.com/gh_mirrors/circ/circuitjs1

深夜十一点，李然盯着宿舍桌上那堆电阻、面包板和万用表，第三次把一根杜邦线插错了位置。他只想验证"RC 振荡电路到底能不能起振"，但接线、断电、检查、再接线，半小时过去了，示波器屏幕上的波形依然是一片噪声。他忍不住想：如果电路能像写代码那样，改一行参数立刻看到结果，该多好？

这正是 CircuitJS1 Desktop Mod 出现的原因。它是经典 Circuit Simulator 的离线桌面版——把 Paul Falstad 原版、Iain Sharp 用 GWT 改造的浏览器电路仿真器，进一步封装成 Windows / Linux / macOS 上可以直接双击运行的原生应用。下面这张图是它的主界面：上半部分是黑色背景的元件画布，下半部分是实时波形，一个 12kHz 方波信号源经过晶体管网络，在右侧输出变成锯齿波，全程不到一秒钟。

一句话说清它的价值：这是你在电脑上免费搭电路、跑仿真、看波形的"电子实验台"，而且不联网也能用。

这篇文章不打算罗列功能清单，而是带你完成三件真实的事：验证一个电路想法、读懂一段别人写的电路、亲手调出一个能动的波形。做完这三件事，你自然会掌握这个软件。

场景一：三分钟验证一个"不确定能不能行"的电路想法

李然后来用这个软件做的第一件事，就是复现他折腾了半小时的 RC 振荡。他选了软件内置的示例电路（菜单 Circuits → 选择relaxosc.txt弛张振荡器），点下运行按钮，波形立刻在底部示波器上铺开——起振、幅度、周期一目了然。他这才明白：电路能不能跑，不是靠猜的，是可以先仿真的。

这类"验证想法"的场景，是这个软件最常被用到的地方：

• 教材上的公式算完，拿不准结论对不对？把电路画出来跑一遍。
• 想给 LED 串多大限流电阻？从 100Ω 试到 1kΩ，波形和电流随改随看。
• 作业里某个分压网络算错了？软件直接告诉你每个节点的电压。

它最值钱的地方在于**"改参数即见结果"**。拖动电位器滑块、双击电阻改阻值，仿真是连续进行的，你不需要像真实实验那样断电换元件再上电。这种即时反馈把"从公式到直觉"的转化时间从小时级压缩到秒级。

场景二：读懂一份别人写的电路，像看代码注释一样轻松

打开软件，在 Circuits 菜单里能看到三百多个预置示例电路（源文件都放在项目里的src/main/java/com/lushprojects/circuitjs1/public/circuits/目录下）。它们不只是"演示素材"，更是学习电路设计的活教材。

比如想理解共射极放大器，不用去翻教科书里的静态工作点推导——直接打开ceamp.txt，你会看到输入信号、偏置电阻、晶体管和输出负载如何连在一起，然后把鼠标悬停在示波器通道上，对比输入和输出波形的幅度差异，增益的概念一下就具象了。

这些示例覆盖了从基础到进阶的几乎所有常见电路类型：电阻网络、二极管特性、晶体管放大、运算放大器、555 定时器、锁相环、各种数字门电路、电源变换器（BUCK/BOOST），甚至混沌电路和特斯拉线圈。把每个文件当成一个"可运行的注释"，是理解电路拓扑最快的方式之一。

场景三：亲手把方波变成锯齿波，掌握仿真工作流

现在我们把视角拉回截图里那个案例。那张图其实完成了一次完整的仿真流程，值得拆开看：

1. 放置信号源：左上角那个标注 12kHz 的方波发生器，是电路的输入。
2. 搭建处理网络：中间由电阻、电容、晶体管构成的网络，负责把方波"整形"。
3. 挂上示波器：右侧标着out的输出节点接到波形区，同时显示输入（方波）和输出（锯齿波）两路波形。
4. 读数：波形区标出了 Max/Min 电压和时间步长，你可以直接量出周期和幅度。

这套"信号源 → 电路网络 → 示波器观测"的工作流，和真实实验室里的操作完全同构，只是把万用表和示波器换成了软件里的虚拟仪器。学会这套流程，你在软件里的每一次仿真都会遵循同一个清晰套路。

最短上手路径：从拿到源码到跑起第一个电路，只需要 5 分钟

如果你已经下载了打包好的桌面版（Windows、Linux、macOS 都有对应安装包），直接双击运行即可，跳过下面所有命令。如果你想自己从源码构建，按这三步走：

第一步：准备环境。需要 JDK 8 以上、Maven 3 以上，以及 Node.js 和 npm。检查方法：

java -version mvn -version node -v

第二步：获取源码并安装依赖。

git clone https://gitcode.com/gh_mirrors/circ/circuitjs1 cd circuitjs1 npm install

第三步：构建。

• 只想快速在浏览器里体验：npm run devmode，开发模式会直接在当前目录起一个可实时调试的环境；
• 想生成所有平台的桌面应用：npm run build，产物会输出到./out/目录，Windows、Linux、macOS 的版本各就各位。

跑起来之后，随便打开一个预置电路，按空格键启动/停止仿真，你的第一个电路就已经在"运行"了。

两个由浅入深的小任务，边做边会

光看不练没有用。这两个任务都不需要写一行代码，但能让你把软件的核心操作过一遍。

任务一：用三个电阻验证分压公式（5 分钟）

1. 新建空白电路，从绘制菜单拖入一个电压源（比如 5V）和两个电阻（1kΩ 和 1kΩ）串联。
2. 在分压节点和地之间挂一个电压表（或直接用示波器观察节点）。
3. 运行仿真，读出中间节点的电压——理论值 2.5V，软件会告诉你它算出来的结果。
4. 把其中一个电阻改成 2kΩ 再跑一次，观察电压如何变化。

做完你会发现：欧姆定律不是背出来的，是"看"出来的。软件里每个元件旁边都会显示实时参数，电阻两端压降、电流方向都清清楚楚。

任务二：改造一个 555 单稳态电路，观察波形变化（15 分钟）

1. 打开预置电路555monostable.txt（555 定时器单稳态电路）。
2. 找到控制脉宽的 RC 元件（通常是一个电阻加一个电容）。
3. 把电容值翻倍，运行仿真，观察输出波形的高电平持续时间如何变长。
4. 再改回原值，改大电阻，对比两次变化，体会"RC 乘积决定延时"这个结论。

这个任务的价值在于，它把"调参数 → 看波形 → 形成直觉"的循环完整地走了一遍，而这正是电路设计最核心的基本功。

新手最容易踩的 5 个坑

坑 1：把理想元件当成真实元件。项目 README 里特意强调，软件里的元件大多是理想化的，不建议用它来建模真实电路。做电路设计验证、学习原理完全没问题，但别指望仿真结果和真实世界百分百一致（比如真实的二极管压降、晶体管的寄生电容都不会完全模拟）。

坑 2：元件没接好就急着跑仿真。仿真报错时，先检查有没有悬空的引脚、有没有把电源正负极短路。黑色画布上不同颜色的连线代表不同网络，接线乱了先从视觉上排查。

坑 3：时间步长设置不当导致"跑不动"或"看不出变化"。仿真变慢时，先检查是不是时间步长太小、电路太复杂，或者开了太多示波器通道。截图里那个案例用 200ns 的时间步长，说明高频电路需要更精细的步长，但代价是计算变慢，要在精度和速度间找平衡。

坑 4：以为它只是个网页。这是离线桌面版，飞机上、地铁里、实验室没有 Wi-Fi 的时候都能用，别把它当成必须联网的在线工具。

坑 5：修改源码后不知道怎么应用。这个项目有一整套自定义补丁（项目里的patches/目录存放了十几个.patch文件，覆盖元件类、对话框、工具栏等模块）。如果你从上游同步了新代码，需要执行cat patches/*.patch | patch -p0重新应用这些改动，直接替换文件会导致定制功能丢失。

从使用者走向改造者：这个项目还能怎么玩

如果你不满足于"会用"，这个项目提供了很好的进阶空间：

• 看源码学架构。它基于 GWT（Google Web Toolkit）开发，主要源码在src/main/java/com/lushprojects/circuitjs1/client/，每个元件一个类，比如ResistorElm.java、CapacitorElm.java，图形绘制和仿真逻辑都在里面，想搞懂"一个元件是怎么被仿真的"，读一个类就够了。
• 改元件、加元件。参考现有元件类写一个新类，实现绘制和仿真逻辑，就能把它加入元件库——这对想做仿真器二次开发的人来说是一条清晰的路径。
• 做翻译贡献。软件支持 13 种语言（含简体中文、繁体中文、日文、德文、法文等），语言文件在src/main/java/com/lushprojects/circuitjs1/public/目录下的locale_*.txt，改起来非常直观。
• 参与社区。项目衍生自 Paul Falstad 的经典 Circuit Simulator，本身就是开源社区多年沉淀的成果，GPL 许可允许你自由修改和分发。

这个项目最打动我的地方在于它的"时间纵深"：从 Java Applet 时代一路走到 GWT 网页版，再被封装成离线桌面应用，横跨了二十多年的技术演进。今天的你打开它，用的仍然是那个经典到不能再经典的电路仿真内核——但你可以随时钻进源码里，把它改造成你想要的样子。

现在，就动手点亮你的第一个电路

回到李然的故事：他现在已经养成了一个习惯——任何电路想法，先在 CircuitJS1 Desktop Mod 里跑一遍，确认可行再碰烙铁。那块曾让他抓狂的示波器，如今安静地躺在抽屉里，因为大部分"能不能行"的问题，都在软件里提前得到了答案。

你和他之间的距离，只差一次点击运行。打开软件，从resistors.txt开始，拖一个电源、连两个电阻，然后按下空格键——屏幕上那个跳动的电压数值，就是你电子学习旅程的起点。纸上得来终觉浅，这一次，让电路在你眼前动起来。

【免费下载链接】circuitjs1Standalone (offline) version of the Circuit Simulator with small modifications based on modified NW.js.项目地址: https://gitcode.com/gh_mirrors/circ/circuitjs1