CircuitJS1 Desktop Mod 离线电路仿真软件上手全攻略：5步跑通你的第一张电路图

【免费下载链接】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这款免费开源的离线电路仿真软件，就是为你准备的答案。它把整个电子实验室装进你的电脑，双击启动、无需联网，画电路、看波形、调参数全在一个窗口里完成。

传统做法 vs 仿真软件：差距到底有多大

先别急着下载，看看这张对比表，你就明白为什么越来越多人选择用软件学电路：

一句话总结它的核心价值：

• 🆓免费开源：不仅免费，还能翻源码学习
• 📴纯离线：不联网也能跑，没有"服务器繁忙"
• 🌍13 种语言：简体中文界面完整支持
• ⚡实时仿真：改一个电阻值，波形立刻变化
• 📂数百个预设电路：从电阻分压到锁相环，开箱即学

5 步上手：从空文件夹到跑通仿真

这一节面向"第一次用"的你。如果只想快速体验，可以直接下载官方发布版安装包；如果想自己动手构建，跟着下面 5 步走。

第 1 步：准备构建环境

项目基于 Java 技术栈打包桌面应用，需要三样东西：

• JDK 8 或更高版本
• Maven 3 或更高版本
• Node.js（自带 npm）

可以用下面的命令确认是否已安装：

java -version && mvn -version && npm -version

如果提示找不到命令，去对应官网装好再来。这三样缺一不可。

第 2 步：获取源代码

打开终端，克隆项目仓库：

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

克隆完成后，你会看到这样的目录结构（记住这两个关键目录）：

• src/main/java/com/lushprojects/circuitjs1/client/：核心 Java 源码，每个电子元件对应一个类，比如ResistorElm.java、CapacitorElm.java
• src/main/java/com/lushprojects/circuitjs1/public/circuits/：内置的预设电路库，几百个.txt格式的示例电路就躺在这里

第 3 步：安装项目依赖

npm install

这条命令会把 Maven、NW.js 等构建工具下载到本地的node_modules目录，是后续一切构建的基础。

第 4 步：构建应用程序

构建分为几种方式，按需选择：

npm run build

这是最常用的全平台打包命令，会在./out/目录下生成 Windows、Linux、macOS 三个平台的应用。如果你改了 Java 源码、想重新编译 GWT 前端，用完整构建：

npm run full

只想在本地快速跑起来看看效果？用这条：

npm start

它会把应用跑在 NW.js 的开发版里，输出到./target/site/目录，适合日常调试。

第 5 步：运行并验证

打包完成后，进入./out/目录，找到对应你操作系统的文件夹，双击可执行文件（Windows 下是CircuitSimulator.exe）即可启动。

启动成功的标志：出现黑色背景的电路画布、顶部有菜单栏和工具栏，左侧还有可拖动的元件列表。

核心功能逐个击破：第一次使用就看这篇

1. 在画布上搭电路——像拼积木一样简单

这是软件的"主战场"。操作逻辑非常直觉：

1. 从左侧元件栏（或顶部工具栏）点选一个元件，比如电阻
2. 在黑色画布上单击放置，再点一下确定位置
3. 用鼠标从一个元件端点拖到另一个端点，就完成了连线
4. 双击元件可以修改参数，比如把电阻值从 1kΩ 改成 10kΩ

画完你会发现，连线会根据电位自动着色（红色通常代表高电平路径、绿色代表信号通路），电路状态一目了然。

2. 启动仿真，用示波器看波形——最震撼的一刻

点击工具栏的运行/暂停按钮，仿真立即开始。画布上的元件会"活"过来：电流流动、节点电压实时更新。

把鼠标拖到底部的波形区，就能像示波器一样看到信号随时间的变化。下面这张图就是软件的真实界面——输入一个 12kHz 方波，经过电路处理后，输出变成了锯齿波，两条波形同步显示，谁是谁的"加工产物"看得清清楚楚：

波形区支持多通道显示，还能用测量工具直接读取电压、频率等参数。

3. 逛预设电路库——几百个现成案例任你拆

打开顶部Circuits 菜单，里面躺着几百个现成电路，按主题分门别类：

• 入门级：resistors.txt、cap.txt（电阻、电容基础）
• 放大电路：npn.txt、opamp.txt、ceamp.txt
• 数字电路：ttlinverter.txt、jkff.txt、counter.txt
• 趣味案例：ledflasher.txt、pll.txt、triacdimmer.txt

这些文件就存放在上文提到的public/circuits/目录下，想研究某个电路的实现，直接打开对应的.txt文件看结构即可。

4. 切换中文界面——告别英文菜单的煎熬

进入Options（选项）菜单，找到语言设置项，选择"Chinese"即可切换为简体中文界面。语言文件位于public/目录下的locale_zh.txt，如果你觉得某句翻译不顺眼，甚至可以自己改完重新构建。

新手避坑指南：这 5 个坑我替你踩过了

• ❌一上来就画复杂电路：元件连错一根线，查错查到怀疑人生。 ✅先从预设电路开始：加载一个官方示例，用鼠标拖动元件、改改数值，先搞清楚"动哪里、看哪里"。
• ❌以为仿真结果可以直接用于真实硬件：项目官方明确说明，元件都是理想化的，仿真结果用于教学没问题，但别拿去设计真实产品。 ✅把它当"学习加速器"：先仿真验证思路，再决定要不要买元件做实做。
• ❌改完 Java 源码只跑npm run build：改的是源码，但打包用的还是旧编译产物，改了个寂寞。 ✅改动源码后用npm run full：它会先重建 GWT 应用再打包，改动才会生效。
• ❌不知道有撤销，手滑删掉整段电路后崩溃：画布操作没有确认提示，误删是常有的事。 ✅养成 Ctrl+Z 肌肉记忆：撤销、重做（Ctrl+Y）是你的后悔药，配合 Ctrl+D 快速复制元件，效率翻倍。
• ❌离线版和网页版混为一谈：网页版需要联网，桌面版完全离线。 ✅分清两者定位：离线版适合上课、旅途、考试复习等无网场景，体验更稳定。

效率技巧速查：立刻就能用上的 6 个操作

下面这张快捷键表来自软件源码，都是实测有效的操作：

再送你三条"非快捷键"效率心得：

1. 善用/键搜索菜单：元件多到记不住位置时，按/直接输入名称查找，秒级定位。
2. 波形不够直观就调时间轴：信号太快看不清时，把仿真步长调小、显示范围调宽，慢动作观察变化过程。
3. 做完实验随手导出：File 菜单支持把电路导出为图片、文本或本地文件，方便写实验报告或分享给同学，具体格式以官方文档为准。

进阶玩法：从使用者走向贡献者

用顺手之后，你会发现这个项目"越挖越深"：

• 翻译贡献：修改public/locale_*.txt语言文件，就能为某个语言版本做贡献，零门槛入门开源。
• 自定义元件：项目是 GWT + Java 架构，每个元件都是一个 Java 类。参考client/目录下现有元件（比如PotElm.java、ThermistorNTCElm.java）的写法，继承基础类、实现绘制与仿真逻辑，就能创造属于你的元件。
• 开发模式调试：npm run devmode可以在war/目录下直接热调试，改完即时刷新，特别适合折腾界面和功能。

想深入的话，patches/目录里还躺着项目作者对各个文件的修改补丁，对比着看能学到不少打包和适配的技巧。

高频问题 FAQ

Q：这个软件支持哪些操作系统？A：Windows（32/64 位）、Linux（32/64 位）、macOS（Intel 和 Apple Silicon）都支持，构建时按平台分别输出。

Q：完全离线能用吗？A：能。它本质是把仿真引擎打包进本地应用，不需要任何网络连接，教室、飞机上都能用。

Q：界面有中文吗？A：有。项目内置 13 种语言，包含简体中文，在 Options 菜单里一键切换。

Q：仿真结果可以直接拿去做真实电路吗？A：不建议。官方明确说明这是教育用途，元件模型是理想化的（比如没有真实电阻的寄生参数），请以实物测量为准。

Q：想学编程/参与开源，这个项目适合入门吗？A：适合。代码结构清晰、元件类模块化、有完整构建脚本，从改语言文件或加一个小元件开始，比从零写项目友好得多。

现在就去画你的第一张电路图

学电路最难的不是理论，而是"没东西可摸"。CircuitJS1 Desktop Mod 把这个门槛拆掉了——免费、离线、中文、几百个示例，它不像一个软件，更像一个随身携带的电子实验室。

行动指令很简单：现在就去克隆代码跑一次npm run build，或者直接下载官方安装包，打开它，加载一个cap.txt，拖动电容值，看看波形怎么变。十分钟后，你就能体会到"亲眼看见电流流动"的那种爽感。

动手吧，最好的学习方式永远是动手实践。

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