### 配置 VSCode 进行远程调试 Bash 下的 Python 文件 要在 VSCode 中实现对远程服务器上通过 Bash 脚本运行的 Python 文件进行调试，需要完成以下几个方面的配置： #### 1. 安装必要的扩展 确保安装了以下两个扩展： - **Remote - SSH**: 用于连接到远程服务器。 - **Python Extension Pack**: 提供 Python 的开发支持。 这些工具可以通过 VSCode 的市场下载并安装[^1]。 #### 2. 创建 `launch.json` 文件 在 `.vscode/launch.json` 文件中定义调试配置。以下是针对远程调试的一个典型配置示例： ```json { "version": "0.2.0", "configurations": [ { "name": "Python: Remote Debug (via Bash)", "type": "python", "request": "attach", "connect": { "host": "localhost", "port": 5678 }, "pathMappings": [ { "localRoot": "${workspaceFolder}", "remoteRoot": "/path/to/your/server/project" } ], "justMyCode": false, "subProcess": true } ] } ``` 上述配置说明如下： - `"host"` 和 `"port"` 是调试器监听的服务地址和端口[^4]。 - `"pathMappings"` 将本地路径映射到远程服务器上的项目路径。 - `"justMyCode": false` 表示允许调试外部库代码。 #### 3. 修改 Bash 脚本以启用调试模式 为了使 Python 程序能够被附加调试，需修改 Bash 脚本，在其中加入调试命令。例如： ```bash #!/bin/bash PYTHONPATH=/path/to/python/module \ python3 -m ptvsd --host 0.0.0.0 --port 5678 /path/to/script.py arg1 arg2 ``` 此脚本会启动一个带有调试功能的 Python 实例，并绑定到指定的主机和端口[^2]。 #### 4. 设置环境变量与依赖项 某些情况下可能还需要调整环境变量或加载特定模块来满足程序需求。可以在同一 Bash 脚本顶部添加相关内容，比如： ```bash export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/custom/lib/path module load cuda/11.2 cudnn/8.1 ``` 这样可以保证运行时所需的动态链接库和其他资源正常加载[^3]。 #### 5. 启动调试过程 按照顺序依次操作： - 使用 SSH 插件登录目标机器； - 执行经过改造后的 Bash 脚本开启服务； - 返回至本地实例切换回对应的工作区目录下触发 Attach 功能即可开始单步跟踪分析等工作流程. ---