Skip to content

module 命令使用教程

在高性能计算（HPC）平台上，用户通常需要使用不同的软件和库。为了避免不同版本之间的冲突，HPC 系统会使用 Environment Modules 工具来进行软件环境的管理。 module 命令可以帮助用户方便地 查看、加载、卸载、切换和清理环境。

1. 基本介绍

  • module 命令由 Environment Modules 软件提供
  • 每个软件或库对应一个 module 文件，里面定义了如何设置环境变量（如 PATH, LD_LIBRARY_PATH 等）
  • 用户通过 module load xxx 就能加载所需软件环境，而无需手动设置环境变量

2. 常用命令

（1）查看可用环境

module avail

作用：列出系统中所有可用的软件模块。 输出示例：

------------------- /apps/support/modulefiles -----------------------------------
intel/cmake/3.26.3                                intel/grib_api/1.21.0           
intel/openjpeg/1.5.2                              amd/intel_parallel_studio/2020.4       intel/gromacs/2018.8/intel2024.2_impi_double      intel/openmpi/3.1.0/gcc8.5.0

（2）查看已加载的环境

module list

作用：显示当前用户加载的所有软件模块。 输出示例：

Currently Loaded Modules:
  1) intel/openmpi/3.1.0/gcc8.5.0   2) intel/cmake/3.26.3    3) intel/openjpeg/1.5.2

（3）加载模块

module load <模块名>/<版本号>

例子：

module load intel/openmpi/3.1.0/gcc8.5.0
module load intel/cmake/3.26.3

（4）卸载模块

module unload <模块名>/<版本号>

例子：

module unload intel/cmake/3.26.3

（5）切换模块版本

module switch <旧模块> <新模块>

例子：

module switch intel/cmake/3.26.3  intel/cmake/3.19.8

（6）清空所有已加载的模块

module purge

作用：卸载所有已加载的软件模块，恢复到初始环境。

（7）查看模块详细信息

module show <模块名>/<版本号>

例子：

module show intel/cmake/3.26.3

会显示该模块修改的环境变量（如 PATH、LD_LIBRARY_PATH 等）。

3. 使用示例

假设要运行一个 MPI 并行程序，步骤可能如下：

module purge
module load intel/gcc/8.5.0
module load intel/openmpi/3.1.0/gcc8.5.0
mpirun -n 16 ./my_program

4. 小结

  • module avail → 查看可用软件
  • module list → 查看已加载的软件
  • module load/unload → 加载或卸载软件
  • module switch → 切换版本
  • module purge → 清空环境
  • module show → 查看模块详情