如何在NS3中修改现有模块部分文件并添加修改后的模块？

阿华AIGC实验室

2026-5-6

刚好我之前在NS3里折腾过模块定制的事儿，给你梳理下可行的方案，解决你遇到的编译冲突问题：

方案一：临时修改原模块（快速测试用）

如果只是临时改点代码做测试，完全没必要新建模块——直接修改原AODV的文件就行：

找到NS3源码目录下的src/aodv，修改你需要的文件（比如model/aodv-routing-protocol.cc）
重新执行./waf configure --enable-examples --enable-tests，然后./waf build
注意：最好用Git分支或者备份原文件，避免搞乱官方源码。

方案二：创建独立的新模块（长期定制用）

你之前复制AODV到aodv-mod后编译冲突，核心原因不是文件名没改全，而是代码里的类名、命名空间、模块注册标识还和原AODV完全一致，编译器碰到重复的符号定义就炸了。要做独立模块，必须改这些关键标识，不过不用手动改所有文件，重点改以下几部分：

1. 重命名核心文件

复制src/aodv到src/aodv-mod后，先把最核心的几个文件重命名：

把helper/aodv-helper.h/.cc改成aodv-mod-helper.h/.cc
把model/aodv-routing-protocol.h/.cc改成aodv-mod-routing-protocol.h/.cc
其他内部辅助文件（比如model/aodv-rqueue.h）如果是模块内部用的，可以暂时不改名，但最好统一前缀，避免后期混淆。

2. 调整CMake配置

打开src/aodv-mod/CMakeLists.txt，全局替换所有aodv为aodv-mod：

set(library_name aodv-mod)
set(source_files
  model/aodv-mod-routing-protocol.cc
  helper/aodv-mod-helper.cc
  # 其他源文件保持原路径，除非你改了文件名
)
set(header_files
  model/aodv-mod-routing-protocol.h
  helper/aodv-mod-helper.h
)

# 模块注册部分也要改
ns3_module_library(${library_name} ${source_files} ${header_files})
ns3_module_link_libraries(${library_name} core internet)

同时修改module.dox，把模块名改成aodv-mod，文档描述也对应调整。

3. 修改代码里的命名空间和类名

打开所有头文件和源文件，做以下替换：

把namespace ns3 { namespace aodv {改成namespace ns3 { namespace aodv_mod {（用下划线避免横线的语法问题）
把类名AodvRoutingProtocol改成AodvModRoutingProtocol，AodvHelper改成AodvModHelper
检查代码里的所有类引用（比如Helper里创建路由协议的代码），确保指向新的类名和命名空间。

4. 更新模块注册

打开src/aodv-mod/module.cc，把NS3_MODULE_INITIALIZE(Aodv)改成NS3_MODULE_INITIALIZE(AodvMod)，并确保命名空间是aodv_mod。

5. 编译新模块

执行以下命令配置并编译：

./waf configure --enable-modules=aodv,aodv-mod  # 同时保留原AODV和新模块
./waf build

更简洁的方式：基于继承扩展原模块

如果你的修改只是小范围重写几个方法，完全不用复制整个模块——用NS3的继承机制更高效：
新建一个类继承自原AodvRoutingProtocol，重写需要修改的方法，再写一个对应的Helper类，比如：

#include "ns3/aodv-routing-protocol.h"
#include "ns3/aodv-helper.h"

namespace ns3 {
namespace aodv_mod {

class AodvModRoutingProtocol : public aodv::AodvRoutingProtocol
{
protected:
  // 重写你需要修改的方法，比如路由请求定时器到期逻辑
  void RouteRequestTimerExpire (Ptr<RreqQueueEntry> entry) override
  {
    // 你的自定义代码
  }
};

class AodvModHelper : public aodv::AodvHelper
{
public:
  static Ptr<Ipv4RoutingProtocol> Create (Ptr<Node> node) const override
  {
    Ptr<AodvModRoutingProtocol> protocol = CreateObject<AodvModRoutingProtocol>();
    protocol->SetNode(node);
    return protocol;
  }
};

} // namespace aodv_mod
} // namespace ns3

把这段代码做成一个小模块（甚至直接放到你的仿真脚本目录里编译），就可以在脚本里用AodvModHelper替代原AodvHelper，不用动原AODV的任何代码，也不会有编译冲突。