vscode remote ssh debug python

### 配置 VSCode 使用 Remote SSH 调试 Python 代码 为了在 VSCode 中通过 Remote SSH 调试 Python 代码，可以按照以下方法操作： #### 安装必要的扩展 首先，在本地安装 **Remote - SSH** 扩展以及 **Python** 扩展。这可以通过打开 VSCode 的扩展市场并搜索 `Remote - SSH` 和 `Python` 来完成[^2]。 #### 设置 SSH 连接 创建一个新的连接配置文件 `.ssh/config` 或编辑现有的配置文件以添加目标服务器的信息。例如： ```plaintext Host myserver HostName example.com User username Port 22 ``` 确保能够成功通过命令行使用 `ssh myserver` 登录到远程主机。如果遇到指纹验证提示，运行以下命令来确认服务器的真实性： ```bash ssh-keygen -l -f /etc/ssh/ssh_host_key.pub ``` 并将显示的指纹与 Visual Studio Code 提供的一致性进行核对。 #### 在远程环境中设置 Python 解释器 登录到远程机器后，需确保已正确安装 Python 并可被识别。可通过执行以下命令检查版本： ```bash python --version ``` 或者对于 Python 3.x 版本： ```bash python3 --version ``` 接着，在 VSCode 内部选择合适的解释器路径。通常情况下，VSCode 自动检测可用的 Python 环境；如果没有自动检测，则手动指定解释器位置[^1]。 #### 创建调试配置 在项目根目录下找到或新建 `.vscode/launch.json` 文件，定义调试会话参数如下所示： ```json { "version": "0.2.0", "configurations": [ { "name": "Python: Remote Attach", "type": "python", "request": "attach", "connect": { "host": "localhost", "port": 5678 }, "pathMappings": [ { "localRoot": "${workspaceFolder}", "remoteRoot": "/path/to/your/project/on/server" } ] } ] } ``` 上述 JSON 块中的端口号 (`port`) 应匹配实际使用的调试监听端口，而映射路径则应反映本地工作区与远程服务上的对应关系。 #### 启动远程调试模式 最后一步是在远程终端启动调试服务器。假设已经安装好 `ptvsd`（Python Tools for Visual Studio Debugger），那么可以用下面的方式激活它： ```python import ptvsd # Allow other computers to attach to ptvsd at this IP address and port. ptvsd.enable_attach(address=('0.0.0.0', 5678), redirect_output=True) print("Waiting for debugger attach") ptvsd.wait_for_attach() ``` 这段脚本会在程序暂停等待直到有客户端附加为止。 当所有组件都准备就绪之后，点击 VSCode 左侧工具栏里的绿色三角形按钮即可触发调试过程。 ---