简介《KiCad入门(中文版).pdf》是一份面向电子设计初学者与开源硬件爱好者的中文入门教程针对KiCad 5.1.8版本编写帮助零基础读者从软件安装一路走到独立完成原理图与PCB设计。内容覆盖KiCad工具套件构成、跨平台下载安装、前后向注释工作流程、常用快捷键、Eeschema绘制原理图与总线连接、Pcbnew布局布线、Gerber文件生成与GerbView检查、FreeRouter自动布线以及自定义原理图符号与元件封装的制作方法并专门提示项目文件可移植性与版本兼容问题。资源包共1个PDF文件约1.21MB轻量便携适合随时查阅。目前已有6195人学习教程按章节组织、条理清晰读者可据此系统掌握KiCad核心操作少走弯路快速上手开源EDA工具并投入实际电路板设计。1. 装 KiCad 之前先把版本和依赖理清楚上周帮一个做硬件的朋友收拾电脑他装了三遍 KiCad每次打开 Pcbnew 都提示封装库为空原理图里放个电阻都搜不到。最后发现不是软件坏了是他把 nightly 包和稳定版混着装库路径指向了两个不同的目录。这种翻车在 KiCad 入门阶段特别常见——软件本身装上了但库没挂对等于装了个空壳。KiCad 是一套开源 EDA 工具链做原理图和 PCB 都靠它配套的中文入门文档覆盖了从下载安装到 Gerber 输出的完整流程。这篇笔记按「环境准备 → 安装 → 库配置 → 验证」的顺序走一遍适合刚接触 PCB 设计、准备用 KiCad 画第一块板的开发者。装不好最典型的后果就是库找不到、封装对不上、Gerber 导出来是空的后面每一步都卡。2. 安装 KiCad三个平台的实际操作和版本取舍2.1 先定版本稳定版还是每夜构建KiCad 的发布策略分两条线稳定版定期发布功能经过测试每夜构建nightly带最新功能但文档里写得很直白——可能引入文件损坏、生成坏 Gerber 这类错误。我一般建议入门阶段锁稳定版等你能独立走完「原理图 → 封装分配 → 布线 → Gerber」全流程之后再考虑切 nightly 尝鲜。版本选择上还有一个容易忽略的点中文入门文档对应的是 KiCad 5.x 时代的界面和操作逻辑比如 Eeschema、Pcbnew 这些工具名和菜单结构。如果你直接装最新的 7.x 或 8.x界面布局和部分菜单项会有差异照着文档操作时找不到对应按钮。稳妥做法是先用文档匹配的 5.1.x 稳定版把流程跑通熟悉工作流之后再升级。升级时项目文件一般能向上兼容但反过来用旧版打开新版文件会出问题这点在文档第 9 章「项目文件可移植性」里也提到了。2.2 Linux 下用包管理器装大多数发行版的软件源里都有 KiCad 稳定版直接装就行。以 Debian 系为例# 更新软件源索引 sudo apt-get update # 安装 KiCad 主程序和英文文档包 sudo apt-get install kicad kicad-doc-en这两条命令的逻辑很简单apt-get update刷新包列表install拉取 kicad 主包和文档包。kicad-doc-en是英文文档中文文档包在部分源里叫kicad-doc-zh装之前可以用apt-cache search kicad-doc确认一下实际包名。如果发行版源里的版本太旧文档给了一条 PPA 的路子# 添加第三方维护的 KiCad PPA 源 sudo add-apt-repository ppa:js-reynaud/ppa-kicad # 刷新并升级已安装的包 sudo aptitude update sudo aptitude safe-upgrade # 安装 KiCad 和文档 sudo aptitude install kicad kicad-doc-en这里add-apt-repository把 PPA 写进源列表safe-upgrade只做不会破坏依赖的升级。注意 PPA 里的包更新频率高可能混入较新的构建装完用kicad --version确认一下实际版本号别以为装的是稳定版结果拿到的是开发版。Fedora 系走 copr# 启用 KiCad 的 copr 仓库 sudo dnf copr enable kicad/kicad # 安装 KiCad sudo dnf install kicadcopr enable注册仓库dnf install装主程序。Fedora 用户如果只想用稳定版优先查官方源里的kicad包copr 那条路更适合想跟进新构建的情况。2.3 Windows 和 macOS 走安装包Windows 和 macOS 没有包管理器那么顺手的路径直接下安装包。文档给的下载入口是官方镜像站按平台分 stable 和 nightly 两个目录。Windows 下选.exe安装包双击后一路下一步安装向导里会问库的安装位置默认路径一般是C:\Program Files\KiCad\share\这个路径后面配库的时候要用到记一下。macOS 下是.dmg拖进 Applications 即可。装完之后第一次启动可能会提示「无法验证开发者」去系统设置的隐私与安全性里放行一次就行这不是软件问题是 macOS 的 Gatekeeper 机制。提示Windows 安装时如果自定义了安装目录后面在 Eeschema 里配符号库路径时要填你实际选的目录别照抄默认路径。2.4 装完先确认主程序和库都在安装完成后别急着建项目先做一次基础确认。Linux 下终端执行# 查看 KiCad 版本 kicad --version # 确认库目录存在里面应该有大量 .lib 和 .dcm 文件 ls /usr/share/kicad/library/ | head -20第一条输出类似5.1.8的版本号第二条列出库目录下的文件。如果第二条报「No such file or directory」说明库包没装上Linux 下补装kicad-library包Windows 下重新跑安装程序勾选库组件。这一步看着多余但后面配库出问题时你能快速判断是「库没装」还是「路径没配」。3. 配置符号库和封装库路径写错是最常见的坑3.1 符号库的挂载逻辑KiCad 的库分两层符号库.lib.dcm给 Eeschema 用封装库.kicad_mod或.pretty目录给 Pcbnew 用。符号库通过「符号库表」管理表里每一行是一个库的昵称和实际文件路径的映射。Eeschema 找元件时先查表再按路径去读文件所以路径错一个字元件就搜不到。文档第 4.1 节里有一段操作值得单独拎出来在 Eeschema 里点「首选项 → 管理符号库」会看到「全局库」和「项目专有库」两个标签页。全局库对所有项目生效项目专有库只对当前项目生效。入门阶段建议把常用库挂全局项目特有的库挂项目专有避免每个新项目都重配一遍。3.2 手动添加一个库的完整步骤以添加MCU_Microchip_PIC12.lib为例这是文档里的实操例子打开 Eeschema菜单「首选项 → 管理符号库」。切到「项目专有库」标签页。点表格下方的文件浏览按钮定位到库目录。Windows 一般是C:\Program Files\KiCad\share\Linux 是/usr/share/kicad/library/。选中MCU_Microchip_PIC12.lib确认添加。在列表里把昵称改成microchip_pic12mcu点确定关闭。改昵称这一步不是可有可无的。KiCad 里元件引用格式是「昵称:元件名」昵称太长或者带特殊字符后面在原理图里搜索和引用都别扭。我一般把昵称统一成小写加下划线跟项目里的命名习惯保持一致。3.3 封装库的配置差异封装库的配置入口在 Pcbnew 里菜单「首选项 → 管理封装库」。逻辑和符号库类似但封装库是目录形式.pretty结尾的文件夹一个目录里放多个.kicad_mod文件。配置时指向目录而不是单个文件这点和符号库不同第一次配容易搞混。文档第 5.1 节讲 Pcbnew 使用时提到封装分配但没展开库路径的细节。实际做法是在封装库表里新增一行昵称填库名路径填.pretty目录的完整路径。配完之后在 Pcbnew 里按O打开封装选择器能搜到元件就说明挂对了。注意符号库和封装库是两套独立的表别以为配了符号库封装库就自动有了。原理图里放好元件后还要在 Pcbnew 里给每个元件分配封装这一步漏了PCB 上就是空的。3.4 库路径的跨平台写法同一个项目在不同系统间迁移时库路径是最大的麻烦。Windows 写C:\Program Files\KiCad\share\...Linux 写/usr/share/kicad/library/...路径分隔符和根目录都不一样。KiCad 支持用环境变量做路径前缀比如KICAD_SYMBOL_DIR指向符号库根目录库表里写${KICAD_SYMBOL_DIR}/MCU_Microchip_PIC12.lib换平台时只改变量值库表不用动。这个做法在文档第 9 章「项目文件可移植性」里有对应思路但没给具体配置。我的习惯是个人项目统一用环境变量前缀团队项目在项目目录下放一份库副本库表指向相对路径这样整个项目目录打包发给别人也能直接打开。4. 避坑排查五条装 KiCad 时真踩过的坑4.1 打开 Eeschema 提示「符号库为空」现象新建项目进 Eeschema按A添加符号选择窗口里一个库都没有。原因符号库表没初始化或者全局库表指向的路径不存在。常见于 Linux 下只装了kicad没装kicad-library或者 Windows 安装时取消了库组件。解决先确认库目录存在见 2.4 节再进「管理符号库」检查全局库表里是否有条目。表是空的就手动添加库目录或者删掉用户配置目录下的符号库表文件让 KiCad 重新生成。Linux 下配置文件一般在~/.config/kicad/Windows 在%APPDATA%\kicad\。4.2 元件能放但分配封装时搜不到现象原理图画完了进 Pcbnew 分配封装封装选择器里搜不到对应元件。原因封装库没配或者配了但路径指向的.pretty目录里没有对应文件。另一种情况是符号和封装的命名对不上比如符号叫R封装库里叫Resistor_SMD:R_0805搜索关键词不对。解决先在 Pcbnew 的封装库管理里确认库表有条目且路径有效再用封装选择器的过滤器按库名筛选。文档第 8 章讲封装制作时提到封装命名规范自己做的封装建议按「库名:封装名」的格式命名减少搜索时的歧义。4.3 生成 Gerber 后 GerbView 里看不到图形现象Pcbnew 里导出 Gerber用 GerbView 打开一片空白。原因导出时没勾选对应的层或者层映射配错了。Gerber 是按层导出的顶层、底层、丝印、阻焊各是一个文件只导了空层自然看不到东西。解决导出前在 Pcbnew 的「文件 → 绘制」里确认勾选了所有需要的层导出后逐个文件在 GerbView 里打开检查。文档第 5.2 节讲 Gerber 生成时列了层清单照着核对一遍。这个坑我踩过一次导出的文件数量对但内容是空的原因是层映射里把铜层映射到了不存在的层号。4.4 自动布线跑完板子全是飞线现象用 FreeRouter 自动布线跑完提示完成但 Pcbnew 里看还是飞线。原因自动布线前没有做「前向注释」Pcbnew 里的网络表和原理图不一致布线器拿到的连接关系是空的或者过期的。解决布线前先在 Eeschema 里执行前向注释文档第 6 章把原理图的网络表同步到 Pcbnew确认飞线显示正常再跑自动布线。自动布线只是辅助复杂板子跑完还要手动调整别指望一键出成品。4.5 项目换台电脑打开库全丢了现象项目从台式机拷到笔记本打开后元件显示问号封装全红。原因库表里写的是绝对路径换机器后路径不存在。或者用了项目专有库但库文件没跟着项目一起拷。解决按 3.4 节的思路改用环境变量前缀或者把项目用到的库复制到项目目录下库表改相对路径。文档第 9 章专门讲了这个问题的成因核心就是「库和项目要一起走」。5. 装完怎么验证从空项目到一块能出 Gerber 的板装完配完最后一步是跑一遍最小闭环确认整条链路通。我一般用一个电阻加一个 LED 的小电路做验证十分钟能走完但能暴露库、注释、导出三个环节的问题。第一步新建项目。打开 KiCad 项目管理器「文件 → 新建 → 项目」命名verify勾选「创建新目录」。项目文件自动带.pro扩展名所有文件都放在这个目录下。第二步画原理图。进 Eeschema按A放一个电阻设备库的R按V把值改成1k再放一个 LED设备库的LED按P放VCC和GND电源符号按W连线把电阻、LED、电源串起来。保存。第三步分配封装。回项目管理器进 Pcbnew按O打开封装选择器给电阻分配Resistor_SMD:R_0805给 LED 分配LED_SMD:LED_0805。如果搜不到回第 3 章检查封装库配置。第四步前向注释。在 Eeschema 里点「工具 → 更新 PCB」把网络表同步到 Pcbnew。同步后 Pcbnew 里应该能看到两个元件和它们之间的飞线。第五步布线并导出 Gerber。手动连两根线或者跑一次 FreeRouter。然后「文件 → 绘制」勾选F.Cu、B.Cu、F.Silkscreen、F.Mask四层导出。用 GerbView 逐个打开导出的文件能看到图形就说明整条链路通了。验证时重点看三个信号Eeschema 里元件能搜到库通、Pcbnew 里飞线正常注释通、GerbView 里图形可见导出通。三个都过这套环境就算装好了。提示验证项目别删留着当模板。以后新项目直接复制这个目录改库配置和层设置都是现成的省得每次重配。从那以后我每次装完 KiCad都强制走一遍这个最小闭环再开始正式项目宁可花十分钟验证也不在画到一半时发现库是空的。希望帮到你。本文还有配套的精品资源点击获取