You need to enable JavaScript to run this app. VSCode中如何在Slurm集群的计算节点上调试Python程序?
优惠活动
大模型
产品
解决方案
定价
更多

VSCode中如何在Slurm集群的计算节点上调试Python程序?

VSCode对接Slurm集群计算节点的Python调试实现方案

完全可以不用靠print打日志调程序,以下都是集群用户实际在用的可落地操作:

方案1:通过srun交互式作业直连计算节点(零额外配置,日常调试首选)

操作步骤完全贴合现有使用习惯:

  • 第一步和之前一样,用VSCode的Remote-SSH功能正常登录集群login节点
  • 打开VSCode内置终端,直接提交带GPU资源的交互式Slurm作业,命令可根据自己集群的规则调整:
    srun --partition=GPU分区名 --gres=gpu:1 --mem=32G --pty /bin/bash
    命令执行完成后,终端会直接切换到已分配的计算节点的shell环境
  • 保持这个终端窗口不要关闭,直接在当前VSCode窗口里选择计算节点上对应的Python解释器,打断点、按F5启动调试即可
    关键点:VSCode的远程调试进程会自动跟随当前终端所在的主机环境运行,只要你没有切回登录节点的shell,所有调试操作都不会占用login节点的计算资源

方案2:通过salloc申请固定节点资源,配置VSCode直连计算节点(适合长周期调试场景)

如果需要连续几个小时做调试,交互式srun容易因为网络波动断连,可以用这个方案:

  • 先在login节点上执行salloc命令申请固定时长的计算节点资源:
    salloc --partition=GPU分区名 --gres=gpu:1 --time=4:00:00
  • 资源分配完成后,用squeue -u 你的集群账号名查到本次分配的计算节点的完整主机名(比如常见的gn003、compute-1-8这类格式)
  • 打开VSCode的Remote-SSH配置文件,新增一条计算节点的连接规则:
    Host 临时计算节点
        HostName 刚才查到的计算节点主机名
        User 你的集群账号
        ProxyJump 你之前配置好的login节点的Host别名
    
  • 配置保存后,直接在VSCode的远程连接列表里选择这个“临时计算节点”的条目,整个VSCode的工作区、扩展、调试会话都会完全跑在申请到的计算节点上,和本地开发体验没有区别
    注意:这个连接的有效期和你申请的salloc作业时长一致,作业到期被集群回收后,连接会自动失效,需要重新申请资源

方案3:调试适配器对接批处理进程(适合不想一直持有交互式节点的场景)

如果调试的程序启动时间很长,不想一直占着交互式计算节点,可以用远程调试attach的方式:

  • 先写Slurm批处理脚本,把原来直接启动Python程序的命令改成带debugpy监听的形式:
    python -m debugpy --listen 0.0.0.0:5678 --wait-for-client 你的训练脚本.py
  • 正常把这个脚本提交到Slurm调度,作业会在计算节点上启动Python进程后,一直等待调试客户端接入,不会直接跑程序
  • 在VSCode的调试配置里新增一个Python远程attach的配置项,填入计算节点的地址和刚才设置的5678端口,启动调试后就能直接挂载断点到这个运行在计算节点上的Python进程
    注意:提前和集群管理员确认计算节点的端口开放规则,不要使用集群禁止的端口号

避坑提醒

  • 千万不要在login节点的shell环境下直接点VSCode界面上的调试启动按钮,这个操作默认会把调试进程跑在login节点上,完全违反集群规则
  • 调试时要注意选择计算节点上你自己创建的conda/venv环境作为解释器,不要选login节点上的系统默认Python,否则会出现包路径不匹配的问题
  • 所有调试产生的临时缓存默认存在家目录的共享存储上,不需要额外做文件迁移,不会触发集群的资源使用违规

内容的提问来源于stack exchange,提问作者Miao_txy

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.26 18:27:07