搭建你的第一个SystemC环境

说实话，每次带新人入门SystemC，我最怕听到的就是「环境装了两天还没跑通」。我自己当年也踩过不少坑，从Windows到Linux，从源码编译到包管理器安装，折腾得够呛。今天我就把这几年的经验梳理一下，帮你半小时内跑起第一个Hello World。

SystemC库的下载与选择

先说说库的事儿。SystemC官方库由Accellera维护，目前最新稳定版是2.3.4（2023年发布）。我个人习惯直接从GitHub下载源码包，地址是：https://github.com/accellera-official/systemc。

你可能会问：「要不要用系统包管理器直接装？」嗯，这得分情况：

• Ubuntu/Debian：sudo apt install libsystemc-dev 确实方便，但版本通常偏老（比如2.3.3）。做学习够用，做项目我建议还是源码编译。
• CentOS/RHEL：官方仓库没有SystemC包，老老实实源码编译吧。
• Windows：推荐用MSYS2或直接Visual Studio编译源码。

Linux环境配置（以Ubuntu 22.04为例）

我在项目中用过最多的就是Ubuntu。配置过程其实就四步，我拆开来讲：

第一步：安装依赖

sudo apt update
sudo apt install build-essential cmake git

这里有个坑——g++版本不能太老。SystemC 2.3.4要求C++11以上，Ubuntu 22.04自带的g++ 11完全够用。如果你用Ubuntu 18.04，记得先升级g++。

第二步：下载并解压源码

wget https://github.com/accellera-official/systemc/archive/refs/tags/2.3.4.tar.gz
tar -xzf 2.3.4.tar.gz
cd systemc-2.3.4

第三步：编译安装

mkdir build && cd build
cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local/systemc-2.3.4
make -j$(nproc)
sudo make install

注意这个 -DCMAKE_INSTALL_PREFIX 参数。我习惯把SystemC装到独立目录，而不是默认的 /usr/local。为什么？因为项目可能需要同时测试多个版本，独立目录方便切换。

第四步：设置环境变量

编辑 ~/.bashrc，添加：

export SYSTEMC_HOME=/usr/local/systemc-2.3.4
export LD_LIBRARY_PATH=$SYSTEMC_HOME/lib-linux64:$LD_LIBRARY_PATH

然后 source ~/.bashrc 使其生效。

Windows环境配置（Visual Studio 2022）

Windows下我踩过的坑最多。说实话，如果你只是学习，我建议用WSL（Windows Subsystem for Linux），省心很多。但如果你必须用原生Windows环境，那就跟着我来：

第一步：安装Visual Studio 2022

记得勾选「使用C++的桌面开发」工作负载。CMake的话，VS2022自带，不用额外装。

第二步：下载SystemC源码

和Linux一样，从GitHub下载2.3.4源码包，解压到 C:\systemc-2.3.4。

第三步：用CMake生成VS工程

打开「Developer Command Prompt for VS 2022」，执行：

cd C:\systemc-2.3.4
mkdir build && cd build
cmake .. -DCMAKE_INSTALL_PREFIX=C:\systemc-2.3.4\install

然后打开生成的 systemc.sln，在VS里编译 ALL_BUILD 项目，再编译 INSTALL 项目。

第四步：配置环境变量

在系统环境变量中添加：

• SYSTEMC_HOME=C:\systemc-2.3.4\install
• 在 Path 中添加 %SYSTEMC_HOME%\bin

编译第一个Hello World模型

环境配好了，我们来写个最简单的SystemC程序。说白了，就是验证库能不能正常链接。

代码：hello.cpp

// hello.cpp
#include <systemc.h>

SC_MODULE(HelloWorld) {
    SC_CTOR(HelloWorld) {
        SC_THREAD(say_hello);
    }

    void say_hello() {
        std::cout << "Hello, SystemC World!" << std::endl;
    }
};

int sc_main(int argc, char* argv[]) {
    HelloWorld hello("hello");
    sc_start();
    return 0;
}

这段代码干了什么？SC_MODULE 定义了一个模块，里面有个线程 SC_THREAD，启动后打印一句话。sc_main 是SystemC的入口，相当于C++的 main。

Linux下编译

g++ -I$SYSTEMC_HOME/include -L$SYSTEMC_HOME/lib-linux64 -lsystemc -o hello hello.cpp
./hello

如果看到 Hello, SystemC World!，恭喜你，环境成了！

Windows下编译

在VS中新建一个控制台项目，配置：

• 附加包含目录：$(SYSTEMC_HOME)\include
• 附加库目录：$(SYSTEMC_HOME)\lib
• 附加依赖项：systemc.lib

然后编译运行，同样能看到输出。

知识体系一览

为了让你对整个流程有个直观认识，我画了张图：

这张图把整个流程串起来了。你想想看，从下载库到配置环境，再到编译运行，其实就三个环节。每个环节都有固定的套路，走一遍就熟了。

验证环境是否正常

跑通Hello World只是第一步。我建议你再做个小测试：

// test_systemc.cpp
#include <systemc.h>
int sc_main(int, char*[]) {
    std::cout << "SystemC version: " << SC_VERSION << std::endl;
    return 0;
}

编译运行后，你会看到类似 SystemC version: 2.3.4 的输出。这能确认你链接的确实是目标版本。我在项目中遇到过好几次「以为自己装了新版，结果链接的是系统旧版」的尴尬情况，所以这个测试我一直保留着。

好了，环境搭好了，你的SystemC之旅正式开始了。接下来就可以放心地写模块、跑仿真了。

---