258

How do I run a Python program under debug and set the working directory for the run?

0

12 Answers 12

394

@SpeedCoder5's comment deserves to be an answer.

In launch.json, specify a dynamic working directory (i.e. the directory where the currently-open Python file is located) using:

"cwd": "${fileDirname}"

This takes advantage of the "variables reference" feature in VS Code, and the predefined variable fileDirname.

If you're using the Python: Current File (Integrated Terminal) option when you run Python, your launch.json file might look like mine, below (more info on launch.json files here).

{
    "version": "0.2.0",
    "configurations": [
    {
            "name": "Python: Current File (Integrated Terminal)",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "cwd": "${fileDirname}"
    }, 

    //... other settings, but I modified the "Current File" setting above ...
}

Remember the launch.json file controls the run/debug settings of your Visual Studio code project; my launch.json file was auto-generated by VS Code, in the directory of my current "Open Project". I just edited the file manually to add "cwd": "${fileDirname}" as shown above.

Remember the launch.json file may be specific to your project, or specific to your directory, so confirm you're editing the correct launch.json (see comment)

If you don't have a launch.json file, try this:

To create a launch.json file, open your project folder in VS Code (File > Open Folder) and then select the Configure gear icon on the Debug view top bar.

Per @kbro's comment, you might be prompted to create a launch.json file by clicking the Debug button itself:

When I clicked on the Debug button on my navigation panel it said "To customise Run and Debug create a launch.json file." Clicking on "create..." opened a dialog asking what language I was debugging. In my case I selected Python

13
  • 14
    Any way to set this as a default setting for all configurations?
    – Serhiy
    May 17, 2019 at 8:01
  • 1
    Be sure you're editing the right launch.json file! In my experience VS Code creates a .vscode directory in every project folder I open. If yesterday you opened folder parent/ and today you opened parent/child/, you'll have to make changes appropriately. Oct 26, 2020 at 12:55
  • 1
    There is another file that looks similar to launch.json: workspace[x].code-workspace. It has a 'launch' key. Is this setting there similar to launch.json entries?
    – Timo
    Nov 30, 2020 at 13:33
  • 1
    Can I set the folder in the terminal to the folder the script was?. E.g. my last ps1 script line is set-location foo, I want the terminal to be in foo.
    – Timo
    Nov 30, 2020 at 14:33
  • 3
    This answer did not work for me, but this one did: stackoverflow.com/a/62331298/65326
    – Apreche
    Dec 31, 2020 at 15:50
64

Configure the cwd setting in launch.json as follows:

{
    "name": "Python",
    "type": "python",
    "pythonPath": "python", 
    ...
    "cwd": "<Path to the directory>"
    ...
}
4
  • Yup, did that. I see that it's actually the .vscode directory, so I think I need to add \.. to the end, right? Jul 28, 2016 at 15:38
  • Yes, will amend the answer accordingly
    – Don
    Jul 28, 2016 at 22:39
  • 40
    "cwd": "${fileDirname}" to run in current directory of open source file Oct 31, 2018 at 19:53
  • good to point out the doc
    – liang
    Dec 28, 2021 at 9:32
35

This setting helps me: (I am a Windows person)

{
  "type": "node",
  "request": "launch",
  "name": "Launch Program",
  "cwd": "${workspaceFolder}\\app\\js", // set directory here
  "program": "${workspaceFolder}\\app\\js\\server.js", // set start js here
}
0
31

In some cases, it might be also useful to set the PYTHONPATH along with the workspaceFolder:

{
    "name": "Python: Current File",
    "type": "python",
    "request": "launch",
    "program": "${file}",
    "console": "integratedTerminal",
    "cwd": "${workspaceFolder}",
    "env": {
        "PYTHONPATH": "${cwd}"
    }
}

4
  • 4
    thanks, that helped. but I am not sure I understand why is that needed. Can you explain it please? Jan 26, 2021 at 20:48
  • @HananShteingart, see Python documentation: docs.python.org/3/using/…
    – ahogen
    Mar 5 at 22:22
  • "In some cases" – which cases?
    – Ooker
    May 27 at 16:22
  • @Ooker in the caes where you have a module but you don't know what is happening in your vscode, this happened to me today, I was prepping an environment for fresh-techies where I needed to set up a module with main.py in the root and init.py in almost every sub-directory, at least this was my case. So we needed to run the file, but keep the env for the root as the project root directory
    – mr.xed
    2 days ago
6

I am posting this sample configuration for people who use TypeScript on Node.js

in my project my Node.js server TypeScript files are located in folder Application_ts and the compiled js files are generated in the folder named Application

because when we run our application in debug mode or start it normally we should start from Application folder which contains the js files so bellow configuration run debug from root folder where my application_ts also exists and works perfect

{
  "version": "0.2.0",
  "configurations": [
    {
        "type": "node",
        "request": "launch",
        "name": "Debug TypeScript in Node.js",
        "program": "${workspaceRoot}\\Application\\app.js",
        "cwd": "${workspaceRoot}\\Application",
        "protocol": "inspector",
        "outFiles": [],
        "sourceMaps": true
    },        
    {
        "type": "node",
        "request": "attach",
        "name": "Attach to Process",
        "port": 5858,
        "outFiles": [],
        "sourceMaps": true
    }
 ]
}
3

You can set up current working directory for debugged program using cwd argument in launch.json

4
  • Super! Got me to the next step. Now, trying to actually run the program in debug. here's the code: print (os.getcwd()) Jul 28, 2016 at 13:55
  • Super! Got me to the next step. I have a one-liner: print (os.getcwd()) that I want to debug. I click on the debug icon (or hit F5), There's a little blue moving line under Environment pulldown. However, my code never runs. Guess I'm missing something. What would that be? Jul 28, 2016 at 13:57
  • forget those last two, I got it Jul 28, 2016 at 14:06
  • 1
    Next thing. Using the suggestion, I was surprised to see that the ${workspaceRoot} was not actually the root but the .vscode directory under the root. Is this as expected? If so, I can set cwd to ${workspaceRoot}\.. (on windows anway) Jul 28, 2016 at 15:08
3

In order to make this work globally I had to do the following. Updating only the launch.json file only solves it in the folder where VSCode currently is open.

  1. Locate the settings.json file.

    Windows %APPDATA%\Code\User\settings.json

    macOS $HOME/Library/Application\ Support/Code/User/settings.json

    Linux $HOME/.config/Code/User/settings.json

  2. Update the file.

{
    // -- other default or custom settings from before

    "python.terminal.executeInFileDir": true,
    "launch": {
        "version": "0.2.0",
        "configurations": [
            {
                "name": "Python: Current File",
                "type": "python",
                "request": "launch",
                "program": "${file}",
                "console": "integratedTerminal",
                "justMyCode": true,
                "cwd": "${fileDirname}",
                "purpose": ["debug-in-terminal"]
            }
        ]}
}

More information here and here.

1
  • This worked. The additional line of "purpose": ["debug-in-terminal"] was the difference maker for me from the top answer.
    – mkohler
    Apr 26 at 21:40
2

To set current working directory to whatever file you are executing at the time:

File > Preferences > Settings > Python > Data Science > Execute in File Dir

Thanks brch: Python in VSCode: Set working directory to python file's path everytime

0

I faced the same issue and noticed that when running the which python command in Terminal in Mac it shows me a different path to what I get when I run the which python command in vs code. And also that my file runs properly in the terminal when run using python filename.py

So I copied that path from the terminal and pasted it in VS code into Preferences->Settings->Extensions->Python->Default Interpreter Path and it worked. I hope this helps.

0

I use the "justMyCode = false" so I can also debug and jump into the functions that the main script calls.

{
    // Use IntelliSense to learn about possible attributes.    
    // Hover to view descriptions of existing attributes.    
    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387    
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Current File",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "justMyCode": false,
            "cwd": "${fileDirname}"        }
    ]
}
0

It is important to set PYTHONPATH, you can set it on vscode:

{
    "name": "Python debug",
    "type": "python",
    "request": "launch",
    "program": "${file}",
    "console": "integratedTerminal",
    "cwd": "${workspaceFolder}",
    "env": {
        "PYTHONPATH": "${cwd}"
    }
}

Or just set it on terminal with:

$export PYTHONPATH=/home/user/myproject:$PYTHONPATH

Here /home/user/myproject is your project path.

-1

In my case, I kill debug terminal and re-run.

1
  • This answer does not completely address the question. Please edit and update your answer with further details.
    – moken
    May 1 at 2:03

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.