1. 版本选择是第一步坑：Quartus II与Modelsim的搭配逻辑

先说个我经常遇到的现象：很多同学装Quartus II，直接去官网下最新版，然后装完发现和自己买的开发板不匹配、和教材里的操作界面也对不上，更麻烦的是Modelsim版本和Quartus版本之间互相不认。这种问题我在帮人远程调试时遇到过不下二十次，所以这篇教程的第一章，我先带你把版本这件事理清楚。

Quartus II这个软件是FPGA开发的主流IDE之一，主要用于编写Verilog/VHDL代码、做综合、引脚分配、布局布线以及下载烧录。Modelsim则是专业的HDL仿真工具，用来验证你写的代码功能是否正确。两个软件的关系可以简单理解成：Quartus负责把代码变成硬件电路，Modelsim负责在电路变成实物之前先在电脑里模拟运行一遍。所以它们不是二选一，而是前后配合的关系。

1.1 各版本差异与适用人群对比

我列一个常见的版本对照表，这些都是目前高校教学和自学圈子里用得最多的版本：

如果你用的是市面上常见的黑金、正点原子、小梅哥等开发板，芯片型号通常是EP4CE系列（Cyclone IV），那么Quartus II 13.1是倍率最高的选择。为什么呢？因为13.1对Cyclone IV的支持最成熟，网上的教程资源也几乎全部基于这个版本——从安装到仿真，遇到问题搜一下基本都能找到答案。

1.2 为什么我不建议直接上最新版

很多人有个误区，觉得软件越新越好。在FPGA工具链这里恰恰相反。Quartus Prime（19.1之后的改名版本）虽然功能更强，但有几个问题：

• 对老芯片支持不友好：很多入门开发板用的Cyclone IV，在新版Quartus里虽然也能用，但需要额外安装器件支持包，安装包体积大好几个GB，配置步骤多了不少。
• License机制更复杂：新版Quartus Prime的授权方式和Quartus II不同，网上流传的破解方式经常失效。
• 硬件要求更高：新版软件对电脑内存、磁盘空间的要求明显提升，普通笔记本跑起来卡顿明显。
• 教材和教程脱节：国内高校课程和主流开发板厂商提供的例程，大多还是基于13.1/13.0的操作截图。你用新版去对照旧版教程操作，菜单位置都不一样，很容易卡住。

所以我在这篇教程里以Quartus II 13.1 + Modelsim SE 10.1d这个组合为例，这也是实战中验证过最稳的搭配。如果你用的是Quartus II 15.0或18.1，操作流程大同小异，遇到界面差异时灵活对应即可。

2. Quartus II 13.1安装全流程与首次启动验证

版本定下来之后，就可以开始安装了。Quartus II 13.1的安装包可以从官网下载（需要注册Intel账号），也可以从开发板厂商提供的网盘链接获取。

2.1 下载与解压的注意事项

下载的时候注意区分两个东西：Quartus II软件本体和器件库文件。Quartus II 13.1的完整安装包大约3.5GB，其中软件本体和Cyclone系列器件库是分开下载的。如果你只装了软件没装器件库，建工程时选不到芯片型号，这一步卡住的人非常多。

建议下载这些文件：

• QuartusSetup-13.1.0.162.exe（软件主体）
• cyclone-13.1.0.162.qdz（Cyclone IV器件库，必装）
• modelsim_ase-13.1.0.162.qdz（自带Modelsim ASE版本，可选但建议装）

下载完成后解压，注意安装路径不要出现中文和空格。我见过有人装到D:\软件\Quartus，结果编译时各种莫名其妙的问题，路径里的中文字符在FPGA工具链中经常导致环境变量识别异常。建议直接装到D:\altera\13.1或C:\altera\13.1这类纯英文路径。

2.2 安装步骤与关键选项

运行QuartusSetup-13.1.0.162.exe，安装过程比较傻瓜式，但有三个选项需要留意：

**第一步：选择安装组件。**进入到组件选择界面时，默认只勾选了Quartus II软件本体，你需要手动勾选对应的器件支持。如果之前下载了单独的qdz器件库文件，可以跳过这一步，后续单独安装。建议在这里只装软件本体，器件库单独安装，出问题时好排查。

**第二步：指定安装路径。**继续强调，纯英文路径。我习惯用D:\altera\13.1\quartus作为主目录。

**第三步：安装Modelsim ASE。**这里要特别说明，Quartus II 13.1安装包中自带了一个Modelsim ASE版本，在安装过程中会有选项让你勾选。很多人不知道这个ASE版本和独立安装的Modelsim SE版本有什么区别。简单来说：

ASE版本是Altera定制版，集成在Quartus里，启动仿真时自动关联，不需要额外破解License。缺点是功能裁剪了一部分，调试能力不如SE版本。

如果你只是做课程实验、跑通仿真波形，ASE版本完全够用。但如果你要做较为复杂的仿真调试、用脚本自动化跑仿真，建议单独安装Modelsim SE 10.1d。

安装完成后不要急着打开，先把破解补丁处理掉。在Quartus II 13.1的安装目录下找到bin64文件夹（64位系统），把sys_cpt.dll文件备份一份，然后覆盖破解文件。运行Quartus时选择"Start Evaluation"或加载License文件。

2.3 首次启动验证

启动Quartus II 13.1后，应该能看到欢迎界面。此时先验证一件事：能不能正常新建工程并选到芯片型号。

新建工程（File -> New Project Wizard），在Family栏选择Cyclone IV E，然后在具体型号列表里找到你的开发板对应的芯片型号（比如EP4CE10F17C8）。如果能正常看到并选中，说明器件库安装成功。如果型号列表为空，说明器件库没装对，回到2.1重新安装qdz文件。

首次启动还有一个常见问题：Quartus提示找不到License。如果你暂时没有License，可以先选择"Start 30-day Evaluation"体验模式，但要注意，体验模式不支持编译，只能看界面。想要正常使用，必须配置License文件。

3. Modelsim SE 10.1d的安装、环境变量与激活验证

Modelsim的安装比Quartus稍微麻烦一点，因为涉及到环境变量设置和License管理。很多人在这一步卡住，装完之后打开软件提示License错误。其实理解了原理就不难。

3.1 安装过程与环境变量配置

Modelsim SE 10.1d的安装包大约1.2GB。安装界面同样简单，关键还是路径问题——继续强调纯英文路径。我见过有人装到D:\就业软件\Modelsim，环境变量配置完成后依然打不开，最后发现是中文路径导致的系统变量解析失败。

安装完成后，需要手动添加两个环境变量：

1. LM_LICENSE_FILE：指向License文件所在路径。比如我的License文件放在D:\modeltech64_10.1d\license.dat，那这个环境变量的值就是D:\modeltech64_10.1d\license.dat。
2. MODELSIM_HOME：指向Modelsim安装根目录。比如D:\modeltech64_10.1d。

设置方法：右键"此电脑" -> 属性 -> 高级系统设置 -> 环境变量 -> 在系统变量中新建。

3.2 License激活机制的底层逻辑

为什么要设置LM_LICENSE_FILE这个变量？因为Modelsim用的是FlexLM许可证管理机制。简单理解就是：软件启动时会去检查这个环境变量指向的文件，看里面的密钥是否有效、是否在有效期内。如果环境变量没设置，或者指向的文件内容不对，软件就会报错退出。

破解Modelsim的原理，本质上就是生成一个包含有效密钥的license.dat文件，并让软件启动时能找到它。具体操作是用破解工具（通常在安装包的crack文件夹里）生成license文件，把里面的主机名和MAC地址替换成你自己电脑的信息，保存为license.dat，然后设置环境变量指向它。

这里有个细节容易出错：license.dat文件里的HOSTNAME和MAC地址必须与你电脑实际值一致。查看方法：打开命令提示符，输入ipconfig /all查看MAC地址，输入hostname查看主机名。如果不匹配，即使环境变量设置正确，软件依然会报"Invalid license"。

3.3 安装成功验证

配置完成后，打开Modelsim，正常应该进入类似IDE的界面，左侧为Library面板，右侧为Transcript窗口。

快速验证方法：在Transcript窗口输入命令help，如果返回一堆命令说明列表，说明软件正常启动。还可以在Modelsim里新建一个工程，创建一个简单的Verilog文件，随便写个module test; endmodule，然后点击Compile编译，看是否能编译通过。能通过说明工具链完整可用。

4. Quartus II与Modelsim联合仿真设置

两个软件单独能跑起来还不够，关键是让Quartus调用Modelsim进行联合仿真。这一步设置不对的话，Quartus里点仿真按钮会提示找不到Modelsim。

4.1 仿真工具路径自动关联

Quartus II 13.1自带了对Modelsim的自动检测机制。当你安装Modelsim ASE版本时，路径已经被写入注册表。但如果你单独安装的是Modelsim SE版本，需要在Quartus里手动指定。

菜单路径：Tools -> Options -> EDA Tool Options，在ModelSim-Altera或ModelSim一栏填写Modelsim的安装路径。比如：

D:\modeltech64_10.1d\win64

注意要填到win64这一级，不要只填安装根目录。因为Quartus需要直接调用vsim.exe这个可执行文件，而这个文件在win64目录下。

4.2 设置仿真器类型

在Quartus工程中，还需要设置仿真工具类型，否则Quartus不知道调用哪个软件做仿真。

菜单路径：Assignments -> Settings -> EDA Tool Settings -> Simulation。在Tool name下拉菜单中选择ModelSim-Altera或ModelSim，然后勾选Compile test bench选项，手动添加测试文件。

这里提醒一下：如果Tool name下拉菜单是灰色不可选，说明前面EDA Tool Options里的路径没配对。返回上一步检查路径是否正确。

4.3 针对不同版本的差异

如果你用的是Quartus II 15.0或18.1，设置路径的方式类似，但选项位置会稍有变化。以18.1为例，在Assignments -> Settings里直接有Simulation分类，工具下拉菜单中会多出ModelSim Intel FPGA Edition等选项。选对应版本即可。

需要注意：Quartus II 18.1对应的Modelsim版本是SE 10.5b，如果你用10.1d，在启动仿真时可能报版本不匹配的错误。解决方法是安装对应版本的Modelsim，或者在Quartus设置里手动指定兼容的Modelsim路径。

4.4 首次联合仿真测试流程

配置完成后，用一个简单工程测试联合仿真是否打通：

1. 在Quartus里新建工程，芯片选Cyclone IV E系列，编写一个简单的计数器代码。
2. 另存一个testbench文件（.vt），调用计数器模块并产生时钟和复位信号。
3. 在Assignments -> Settings里添加test bench：点击Test Benches按钮，填写测试文件名称和顶层模块名，添加对应的.vt文件。
4. 回到主界面，点击Processing -> Start Compilation and Simulation，或者Tools -> Run Simulation Tool -> RTL Simulation。

如果一切正常，Quartus会自动启动Modelsim，加载仿真库，运行测试，最终在波形窗口显示仿真结果。

这一步如果失败了，最常见的原因是：Quartus找不到Modelsim的库文件。在启动联合仿真时，Quartus会去当前工程目录下寻找altera仿真库（比如altera_mf、altera_primitives），如果你的工程里调用了Quartus的IP核，但没有编译这些IP库到Modelsim，就会报类似** Error: (vsim-3193) ... not found的错误。

解决方法是：在Modelsim里手动编译Altera仿真库。Quartus安装目录的eda\sim_lib文件夹下包含altera_mf.v、220model.v、altera_primitives.v等文件，需要在Modelsim里新建一个库（如altera_lib），然后将这些文件编译进去。

5. 仿真波形是红色：从代码到波形显示的问题排查

装上软件、跑通联合仿真只是第一步。真正让新手崩溃的，是仿真跑完了，波形窗口里信号全是红色的"XXX"，什么都看不到。这个问题的搜索热度在ModelSim相关话题里一直居高不下，下面把常见的成因和排查方法一次讲清楚。

5.1 红色波形信号的本质含义

先理解一件事：Modelsim波形窗口里，信号状态有几种颜色表示：

• 绿色：信号有效，通常是0或1。
• 红色：信号为X状态，表示未知，或者Z高阻态。
• 蓝色：信号为U状态，表示未初始化。
• 橙色：信号为Z状态，代表高阻。

当整个波形都是红线时，说明仿真时信号状态没有被正确驱动。这不一定是Modelsim出问题，更多时候是你的testbench没有正确激励到被测模块。

5.2 最常见原因一：testbench里没有生成时钟和复位

我见过大量的案例，testbench里只写了模块实例化，没有写always #10 clk = ~clk;这样的时钟生成语句，也没有初始化寄存器为0的信号。

模块没有时钟，内部寄存器永远是X状态，输出自然也是X。加上时钟后，再检查寄存器是否在复位信号释放后能正常跳变。

5.3 最常见原因二：信号层次选错了

在Modelsim的波形窗口里，如果添加信号的方式不对，也容易看到一片红。举个例子：你在工程编译完成后，直接在Library窗口右键模块，选择Add Wave，这时默认添加的是模块顶层接口信号，内部信号看不到。

如果你要观察模块内部的计数器、状态机等信号，需要在Simulate窗口里找到模块实例，右键选择Add Wave，或者在命令行执行add wave -position end sim:/testbench/dut/counter这样的命令。

我建议在testbench里用更直观的方式：把要观察的信号通过reg或wire声明后，直接加到波形窗口。比如：

reg clk; reg rst_n; wire [3:0] count; counter u_counter( .clk(clk), .rst_n(rst_n), .count(count) );

然后在Modelsim中选中这些信号，右键Add Wave。这样做的好处是信号命名直观，不容易看错层次。

5.4 最常见原因三：仿真时间太短，信号还没开始变化

还有一种情况，波形不是全红，而是前面一长段红线，后面变成绿色，但绿色的部分很短。这种通常是仿真时间设置太短。在Modelsim的Run命令中，默认只跑100ns。如果你的时钟周期是20ns，那100ns只能跑5个周期，看不出什么结果。

解决办法：在真实仿真中点击Run All，或者通过命令行执行run 1us甚至更长时间。不要只点击Run按钮一下就完事，那个默认只跑100ns。

5.5 常见原因四：仿真库没有正确加载

还有一类红色波形，是在调用Quartus的IP核（如PLL、RAM、ROM）时出现。因为IP核的仿真模型依赖于Altera的仿真库，如果你没有在Modelsim里正确映射这些库，仿真时IP核内部全是X，输出也就全部是X。

这种情况的排查方法是看Transcript窗口的提示。如果出现类似# ** Fatal: (vsim-3193) Load of "altera_mf" failed的报错，就说明Altera库没加载。处理方式参考我前面4.4说的，先编译仿真库，然后在仿真启动前用vsim -L altera_mf -L altera_primitives ...命令执行仿真。

5.6 排查顺序建议

真遇到红色波形，按照下面顺序排查最有效率：

1. 看Transcript窗口有没有Error/Fatal报错 -> 有则先解决 2. 检查testbench的时钟和复位有没有生成 -> 没有则补 3. 检查波形窗口添加的信号层次对不对 -> 不对则重新添加 4. 延长仿真时间 -> 至少10个时钟周期 5. 确认是否调用了IP核 -> 是则检查仿真库是否加载

5.7 一个完整的排查示例

有一次一个学生发我一段代码，他做的是跑马灯实验，四个LED轮流点亮。仿真波形里四个输出全是红线。我远程看了他的testbench代码，发现他写的是：

initial begin rst_n = 1'b0; #100; rst_n = 1'b1; end

问题出在哪里？他只在initial里产生了复位信号，没有写时钟生成语句。模块内部的所有寄存器因为没有时钟，永远不会跳变。我让他加上：

initial begin clk = 1'b0; forever #10 clk = ~clk; end

然后重新编译仿真，波形就正常了。

这个问题看起来很简单，但确实是新手最容易忽略的一个点。很多人在写testbench时，只关注输入信号的激励，忘了模块内部本质上是一个时序逻辑，必须有时钟驱动才能工作。

我个人在这几年的实际使用中，最大的感触是：Quartus和Modelsim这套工具的安装，其实不需要什么高深技巧，只要把版本搭配和路径规范这两件事处理好，后面基本一路顺畅。很多人装完软件发现用不了，看教程反反复复折腾，仔细一问，十有八九是路径带了中文、License环境变量没配对、或者Quartus和Modelsim版本对不上。如果你现在也卡在安装或者仿真波形不正常的阶段，回过头检查这三个点，大多数问题都能迎刃而解。