本文详解如何在 Shell 脚本中非交互式地运行 Singularity 容器内的命令（如 Python 脚本），避免误用 singularity shell 导致的执行失败、段错误或挂起问题。

本文详解如何在 shell 脚本中非交互式地运行 singularity 容器内的命令（如 python 脚本），避免误用 `singularity shell` 导致的执行失败、段错误或挂起问题。

在 Shell 脚本中调用 Singularity 容器时，一个常见误区是使用 singularity shell 启动交互式 shell，然后在其后直接写 python3 script.py——这并不会在容器内执行该命令。因为 singularity shell 是一个阻塞式交互终端，脚本会在此处暂停等待用户手动退出（如输入 exit 或 Ctrl+D），后续命令仅在容器退出后于宿主机环境中执行，从而导致路径错误、环境缺失，甚至触发原生环境下的段错误（Segmentation Fault）。

✅ 正确做法是使用 singularity exec：它以非交互、单次执行模式启动容器，在容器上下文中运行指定命令，并将标准输入/输出/错误透传至宿主机，完美适配自动化脚本场景。

示例脚本（run_in_container.sh）如下：

#!/bin/bash
# 确保容器镜像和脚本路径存在
IMAGE="myapp.sif"
SCRIPT="python-script.py"

if [[ ! -f "$IMAGE" ]]; then
  echo "Error: Container image '$IMAGE' not found." >&2
  exit 1
fi

if [[ ! -f "$SCRIPT" ]]; then
  echo "Error: Python script '$SCRIPT' not found." >&2
  exit 1
fi

# ✅ 在容器内执行 Python 脚本（自动继承容器内 Python 环境与依赖）
singularity exec "$IMAGE" python3 "$SCRIPT"

⚠️ 注意事项：

• singularity exec 默认使用容器内 /bin/sh 作为解释器；若需显式指定解释器（如 python3），务必确保该可执行文件存在于容器的 $PATH 中（可通过 singularity exec image.sif which python3 验证）；
• 若脚本依赖相对路径的输入文件或输出目录，请使用 -B 参数绑定宿主机路径（例如 -B $(pwd):/work），并在容器内以挂载路径调用（如 /work/data.txt）；
• 对于需要多个命令串联的场景，可用 sh -c 包裹：

  singularity exec myapp.sif sh -c 'cd /opt/app && python3 train.py --epochs 10'

总结：singularity shell 仅适用于人工调试，而 singularity exec 才是 Shell 脚本自动化的标准方式。掌握这一区别，可显著提升 HPC 和容器化科研工作流的稳定性与可复现性。