【VSCode】【Python】The Python path in your debug configuration is invalid

最新推荐文章于 2025-06-02 09:18:33 发布

原创最新推荐文章于 2025-06-02 09:18:33 发布 · 4.3k 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#vscode #python #debug

VSCode 专栏收录该内容

9 篇文章

订阅专栏

本文详细解析了在VSCode中遇到Python解释器路径无效的问题，提供了全面的解决方案，包括如何正确配置用户区和工作区的解释器路径，以及如何进行测试确保配置正确。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

一. 问题

升级 VSCode 后，不知啥时候，python debug 的时候，提示 Python 解释器路径无效？

网上搜了一大堆无用的信息，也不管用的，哎，只能自己去官网折腾和鼓捣了；

总之:

python.pythonPath 从settings 中完全删除是一个巨大的破坏性更改;

-- 此对话已被锁定为过于激烈且仅限于合作者。

二. 环境

环境信息, 如下所示:

# VSCode
版本: 1.57.1 (Universal)
提交: 507ce72a4466fbb27b715c3722558bb15afa9f48
日期: 2021-06-17T13:28:32.912Z
Electron: 12.0.7
Chrome: 89.0.4389.128
Node.js: 14.16.0
V8: 8.9.255.25-electron.0
OS: Darwin x64 19.4.0

# Python
python: 2.7 ❌
python: 3.9 ✅
ms-python.python: v2021.6.944021595
ms-python.vscode-pylance: v2021.6.2

三. 解释

参考：

1. https://github.com/microsoft/vscode-python/wiki/AB-Experiments#tldr

2. https://devblogs.microsoft.com/python/python-in-visual-studio-code-may-2020-release/

3. 弃用 PythonPath

有如下信息:

The python.pythonPath setting is no longer used by the Python extension.
A new optional setting python.defaultInterpreterPath is introduced in the user and workspace scope, from which the extension will read the value when loading a project for the first time.
Changes to the python.defaultInterpreterPath will not be picked up by the Python extension once an interpreter is already selected for the workspace. The extension will also not set nor change the value of this setting, it will only read from it.
A VSCode internal storage is introduced which will now store the interpreter settings in the workspace & workspace folder scope. i.e workspace settings are no longer stored in settings.json/.code-workspace, but an internal storage.
You can change the value stored in workspace settings using Python: Select Interpreter command.
See the Python output channel to check the value of the interpreter selected.
You can clear the value stored using Python: Clear Workspace Interpreter Setting command.

啥意思呢？

我用机器翻译一下:

~~python.pythonPath~~: Python 扩展不再使用该设置。
python.defaultInterpreterPath: 在用户和工作区范围中引入了一个新的可选设置，扩展将在首次加载项目时从中读取值。
python.defaultInterpreterPath: 一旦为工作区选择了解释器，Python 扩展就不会获取对的更改。扩展也不会设置或更改此设置的值，它只从中读取。
引入了 VSCode 内部存储，现在将解释器设置存储在工作区和工作区文件夹范围内。即工作区设置不再存储在 settings.json/.code-workspace 中，而是存储在内部存储中。

- 您可以使用Python: Select Interpreter 命令更改存储在工作区设置中的值。
- 查看 Python 输出通道以检查所选解释器的值。
- 您可以使用Python: Clear Workspace Interpreter Setting 命令清除存储的值。

哎，一言难尽

Path to Python, you can use a custom version of Python by modifying this setting to include the full path. This default setting is used as a fallback if no interpreter is selected for the workspace. The extension will also not set nor change the value of this setting, it will only read from it.

翻译(引用):

对于Python的路径，您可以通过修改此设置以包含完整路径来使用自定义版本的Python。如果没有为工作区选择解释器，则此默认设置用作回退。扩展也不会设置或更改此设置的值，它只从中读取。

环境自动选择过程，如下:

选择具有最新Python 版本的环境
按字母顺序选择第一个

如果想在状态栏得到 "Select Python Environment" 的提示，可以设置 "Select Python Environment" : " " ，重启 VSCode 即可;

The "python.pythonPath" setting in your settings.json is no longer used by the Python extension. If you want, you can use a new setting called "python.defaultInterpreterPath" instead. Keep in mind that you need to change the value of this setting manually as the Python extension doesn’t modify it when you change interpreters. Learn more.

下面给出解决方式;

四. 解决

工作区解释器的路径现在将存储在 VS Code 的持久存储中，而不是settings.json 文件中;

您可以使用Python: Select Interpreter 命令更改特定于工作区的值。在命令面板上使用该命令时，存在一个新选项来指定解释器路径。

4.1 用户区配置

{
    "breadcrumbs.symbolSortOrder": "type",
    "editor.formatOnType": true,
    "editor.codeActionsOnSave": [
        "editor.action.formatDocument"
    ],
    "editor.tabSize": 4,
    "editor.detectIndentation": false,
    "editor.suggestSelection": "first",
    "editor.fontSize": 14,
    "editor.fontLigatures": false,
    "editor.formatOnSave": true,
    // "editor.formatOnType": true,
    "editor.wordWrap": "wordWrapColumn",
    "editor.wordWrapColumn": 140,
    "editor.columnSelection": false,
    "editor.mouseWheelZoom": false,
    "editor.renderWhitespace": "all",
    "editor.renderControlCharacters": true,
    "editor.suggest.shareSuggestSelections": true,
    "editor.renderIndentGuides": true,
    "editor.rulers": [
        100
    ],
    "explorer.confirmDelete": false,
    "extensions.autoUpdate": false,
    // "debug.toolBarLocation": "docked",
    "debug.console.fontSize": 14,
    // "files.autoSave": "afterDelay",
    "files.insertFinalNewline": true,
    "files.autoGuessEncoding": true,
    "files.exclude": {
        "**/.git": true,
        "**/.svn": true,
        "**/.hg": true,
        "**/CVS": true,
        "**/.DS_Store": true,
        "**/*.pyc": true,
        "**/__pycache__": true,
    },
    "git.autofetch": true,
    "git.confirmSync": false,
    "guides.enabled": false,
    "python.defaultInterpreterPath": "${workspaceFolder}/venv2/bin/python",
    // https://github.com/microsoft/vscode-python/wiki/AB-Experiments
    "python.experiments.enabled": true,
    "python.experiments.optInto": [
        // "pythonDeprecatePythonPath",
        // "pythonTensorboardExperiment",
        // "pythonDiscoveryModule",
        // "pythonDiscoveryModuleWithoutWatcher",
        // "pythonJediLSP",
        // "pythonSurveyNotification",
        "All"
    ],
    "python.experiments.optOutFrom": [
        // "pythonDeprecatePythonPath",
        // "pythonTensorboardExperiment",
        // "pythonDiscoveryModule",
        // "pythonDiscoveryModuleWithoutWatcher",
        // "pythonJediLSP",
        // "pythonSurveyNotification",
        // "All"
    ],
    "python.logging.level": "info",
    "python.venvFolders": [
        "${workspaceFolder}/venv2",
        "${workspaceFolder}/venv"
    ],
    "python.venvPath": "${workspaceFolder}/venv2",
    // "markdown.extension.toc.githubCompatibility": true,
    "markdownlint.config": {
        "MD033": false,
        "MD034": false,
    },
    "markdown.extension.katex.macros": {},
    "markdown.extension.toc.levels": "2..6",
    "markdown-pdf.highlightStyle": "github.css",
    // "markdown-pdf.headerTemplate":"<div style=\"font-size: 9px; margin-left: 1cm;\"> <span class='title'></span></div> <div style=\"font-size: 9px; margin-left: auto; margin-right: 1cm; \"> <span class='date'></span></div>",
    "markdown-pdf.headerTemplate": "<div></div>",
    "scm.defaultViewMode": "tree",
    "scm.alwaysShowActions": true,
    "workbench.iconTheme": "vscode-icons",
    "workbench.editor.enablePreview": true,
    "workbench.editor.enablePreviewFromQuickOpen": true,
    "window.zoomLevel": 0,
    "workbench.editorAssociations": {
        "*.ipynb": "jupyter.notebook.ipynb"
    },
    // "workbench.sideBar.location": "left",
    // "workbench.settings.openDefaultKeybindings": true,
    // "workbench.settings.openDefaultSettings": true,
    // "workbench.settings.useSplitJSON": true,
    "terminal.integrated.copyOnSelection": true,
    "terminal.integrated.fontSize": 14,
    "terminal.integrated.profiles.linux": {
        "bash": {
            "path": "bash"
        },
        "zsh": {
            "path": "zsh"
        },
        "fish": {
            "path": "fish"
        },
        "tmux": {
            "path": "tmux",
            "icon": "terminal-tmux"
        },
        "pwsh": {
            "path": "pwsh",
            "icon": "terminal-powershell"
        }
    },
}

重点配置如下信息:

{
    "python.defaultInterpreterPath": "${workspaceFolder}/venv2/bin/python",
    // https://github.com/microsoft/vscode-python/wiki/AB-Experiments
    "python.experiments.enabled": true,
    "python.experiments.optInto": [
        // "pythonDeprecatePythonPath",
        // "pythonTensorboardExperiment",
        // "pythonDiscoveryModule",
        // "pythonDiscoveryModuleWithoutWatcher",
        // "pythonJediLSP",
        // "pythonSurveyNotification",
        "All"
    ],
    "python.experiments.optOutFrom": [
        // "pythonDeprecatePythonPath",
        // "pythonTensorboardExperiment",
        // "pythonDiscoveryModule",
        // "pythonDiscoveryModuleWithoutWatcher",
        // "pythonJediLSP",
        // "pythonSurveyNotification",
        // "All"
    ],
    "python.logging.level": "info",
    "python.venvFolders": [
        "${workspaceFolder}/venv2",
        "${workspaceFolder}/venv"
    ],
    "python.venvPath": "${workspaceFolder}/venv2",
}

4.2 工作区配置

{
    "[python]": {
        "editor.defaultFormatter": "ms-python.python"
    },
    "python.analysis.extraPaths": [
        "./src",
        "./mock",
        "./test",
        "./venv2/bin",
        "./venv2/Lib/python2.7/site-packages"
    ],
    "python.analysis.logLevel": "Trace",
    // "python.analysis.watchSearchPaths": true,
    "python.analysis.typeCheckingMode": "basic",
    // "python.analysis.typeCheckingMode": "strict",
    "python.analysis.diagnosticMode": "openFilesOnly",
    // https://github.com/microsoft/pylance-release/blob/main/DIAGNOSTIC_SEVERITY_RULES.md
    "python.analysis.diagnosticSeverityOverrides": {},
    "python.analysis.useLibraryCodeForTypes": true,
    "python.analysis.autoImportCompletions": true,
    "python.autoComplete.addBrackets": true,
    "python.analysis.completeFunctionParens": true,
    // "python.autoComplete.addBrackets": false,
    // "python.analysis.completeFunctionParens": false,
    "python.autoComplete.extraPaths": [
        "./src",
        "./mock",
        "./tests",
        "./venv2/bin",
        "./venv2/Lib/python2.7/site-packages",
        // "./venv/bin",
        // "./venv/Lib/python3.7/site-packages",
    ],
    // "python.autoUpdateLanguageServer": true,
    // "python.defaultInterpreterPath": "${workspaceFolder}/venv2/bin/python",
    // "python.defaultInterpreterPath": "venv2/bin/python",
    // "python.diagnostics.sourceMapsEnabled": true,
    "python.envFile": "${workspaceFolder}/.env",
    // "python.pythonPath": "${workspaceFolder}/venv2/bin/python",
    // "python.pythonPath": "venv2/bin/python",
    // "python.pythonPath": "venv2\\Scripts\\python.exe",
    "python.formatting.provider": "yapf",
    "python.formatting.yapfArgs": [
        "--style",
        "{based_on_style: pep8, indent_width: 20}"
    ],
    // "python.formatting.yapfArgs": [
    //     "--style", "{based_on_style: pep8 ,indent_width: 4, column_limit: 140}",
    // ],
    // "python.languageServer": "Jedi",
    "python.languageServer": "Pylance",
    // "python.languageServer": "Microsoft",
    // "python.logging.level": "info",
    "python.linting.enabled": true,
    "python.linting.flake8Enabled": true,
    "python.linting.flake8Args": [
        "--max-line-length=140",
        // "--ignore=E251",
        "--verbose",
    ],
    "python.linting.ignorePatterns": [
        ".vscode/*.py",
        "**/site-packages/**/*.py"
    ],
    "python.linting.lintOnSave": true,
    "python.linting.pylintEnabled": false,
    "python.testing.unittestArgs": [
        "-v",
        "-s",
        "./tests",
        "-p",
        "test_*.py"
    ],
    // "python.testing.autoTestDiscoverOnSaveEnabled": true,
    "python.testing.cwd": "${workspaceFolder}",
    "python.testing.nosetestsEnabled": false,
    "python.testing.pytestEnabled": false,
    "python.testing.promptToConfigure": false,
    "python.testing.unittestEnabled": true,
    // "workbench.settings.openDefaultSettings": true,
    // "workbench.settings.editor": "ui",
    // "workbench.settings.openDefaultKeybindings": true,
    // "workbench.settings.useSplitJSON": true,
}