How to debug remote Python script in VS Code

Question

I am doing python development in Raspberry Pi . I have installed vs code in my laptop and have installed the ssh extension. Using this I can easily connect to Raspberry pi . While I am connected I can see that vs code has also loaded the python interpreter of Raspberry pi . I can run my python script from within the vs code but when I tried to debug the code, nothing happens. Is it not possible to remotely debug the python script from laptop to raspberry pi?

How can I enable remote debugging. Please help. Thanks

Answer 1

I have resolved this issue. If anyone wants to do remote development and debugging , follow below steps:

1. Install remote ssh extension in VS code
2. Once installed, you will find a green icon on the bottom left corner in vs code which allows us to connect to the remote machine.
3. Connect to the remote machine using the standard ssh command. Alternatively, you can use ssh-keygen to generate a public-private key if you don't want to use the password at every prompt.
4. Once you are connected to remote machine, you can open the file explorer and create any python file. When you will save this, it will get saved in your remote machine. This way you are using your machine to remotely develop code on another remote machine.
5. Good thing about vs code is that it selects the remote machine's python interpreter so all the packages which you have installed on your remote machine will work with IntelliSense.
6. In order to debug the code, we will use debugpy . Install this on both machine (remote & local)
7. On your remote machine, run below command:

python3 -m debugpy --listen 1.2.3.4:5678 --wait-for-client app.py

here 1.2.3.4 is the IP of remote machine. This will start a remote debugger which will wait for a clients connection.

8. On your local machine, in VS code open Run & Debug, add a configuration of Python: Remote Attach . Make sure that launch.json has the host as the IP of your remote machine and port as 5678.
9. Now start debugging as normal and you will notice the code will break at first breakpoint and from here you can proceed normally as we used to do in local debugging process.

TBH, this is best feature VS code has because most of the software allows you to do remote development which is nothing but just a normal SSH but remote debugging gives you more control. I was doing some python project on Raspberry Pi and obviously cannot install VS code or pycharm on it. But with this feature now I can easily develop the code using Pi's python interpreter and debug it as well.

If anyone is having any issues, let me know. Happy to help.