VSCode（Visual Studio Code）是一款强大的源代码编辑器，它支持多种编程语言，包括Python。在进行远程开发时，能够远程调试Python代码是极其重要的功能。这篇文章将详细讲解如何使用VSCode进行远程调试Python程序。
确保你已经在本地安装了VSCode。在这里，我们使用的版本是1.10.2。为了更好地支持Python开发，需要安装Python插件。在本例中，使用的Python插件版本是0.7.0。这个插件提供了许多便利的功能，包括代码高亮、智能感知以及调试支持。
接下来，我们需要配置远程调试环境。在你的工作区根目录下创建一个名为`.vscode`的文件夹，如果不存在的话。在这个文件夹内创建一个`launch.json`文件，这是VSCode调试配置的主文件。以下是一个示例的`launch.json`配置：
```json
{
"version": "0.2.0",
"configurations": [
{
"name": "Attach (Remote Debug)",
"type": "python",
"request": "attach",
"localRoot": "${workspaceRoot}",
"remoteRoot": "/tmp/demo",
"port": 12345,
"secret": "my_secret",
"host": "10.12.34.23"
}
]
}
```
在上述配置中，`localRoot`指本地项目的根目录，`remoteRoot`是远程服务器上对应项目的路径，`port`是用于调试的端口，`secret`是安全密钥，`host`是远程服务器的IP地址。
服务器环境的配置至关重要。你需要在远程服务器上安装Python库`ptvsd`，版本需为3.0.0，因为更高版本可能会导致问题。`ptvsd`库允许你在Python程序运行时进行附加调试。在你的Python入口文件中，添加以下代码来启动调试监听：
```python
import ptvsd
ptvsd.settrace(None, ('0.0.0.0', 12345))
```
这段代码会在指定端口（12345）启动调试服务，等待VSCode连接。
现在可以开始调试了。在服务器上启动你的Python程序，然后在VSCode中设置好断点。回到`launch.json`配置，点击VSCode的调试面板，选择“Attach (Remote Debug)”配置，然后点击绿色的“开始调试”按钮。VSCode将尝试连接到远程服务器，并在遇到断点时暂停执行。
对于Flask应用的远程调试，情况稍微复杂一些，因为Flask在调试模式下会创建子进程来处理HTTP请求。为了捕获这些子进程的调试信息，你需要在Flask应用的初始化阶段调用`ptvsd.settrace()`。以下是一个示例：
```python
# coding:UTF-8
from flask import Flask
import ptvsd
import socket
try:
address = ('127.0.0.1', 11111)
s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
s.bind(address)
except socket.error:
ptvsd.settrace(None, ('0.0.0.0', 12345))
app = Flask(__name__)
@app.route('/')
def index():
a = 5 + 6
return "ok"
if __name__ == '__main__':
app.run(host='0.0.0.0', port=3000, debug=True)
```
通过这种方式，你可以有效地远程调试Flask应用，即使它在子进程中运行。
VSCode的远程调试功能为Python开发者提供了一种高效、便捷的方式，可以在本地环境中控制远程服务器上的代码执行。理解并正确配置`launch.json`文件，以及在远程服务器上正确使用`ptvsd`，是实现这一功能的关键。希望这些信息能帮助你更顺利地进行远程Python开发和调试。
