VSCode运行Python代码出现路径错误怎么办？工作目录设置-VSCode-PHP中文网

VSCode运行Python代码出现路径错误怎么办？工作目录设置

看不見的法師

发布： 2025-07-07 17:19:02

原创

402人浏览过

vscode运行python代码路径出错需正确设置工作目录。1.检查并配置.vscode/settings.json文件；2.设置python.terminal.executeinfiledir为true，使代码在当前文件目录执行；3.通过terminal.integrated.cwd指定全局工作目录，如"${workspacefolder}"；4.使用launch.json配置调试时的工作目录cwd属性，如"${workspacefolder}"或"${filedirname}"；5.若仍出错，检查路径拼写、环境变量、第三方库要求及权限问题。合理配置后可解决大多数路径相关问题。

VSCode运行Python代码出现路径错误怎么办？工作目录设置

很多时候，我们在VSCode里兴致勃勃地写Python代码，一运行，却发现路径出了问题，这可太扫兴了。其实，这问题通常是工作目录没设置对。

要解决VSCode运行Python代码时出现的路径错误，关键在于正确配置工作目录。

解决方案

检查.vscode/settings.json文件： 这是最重要的。在你的项目根目录下，应该有一个.vscode文件夹，里面有个settings.json文件。如果没有，就手动创建一个。

立即学习“Python免费学习笔记（深入）”；
配置python.terminal.executeInFileDir： 在settings.json中，添加或修改python.terminal.executeInFileDir选项。如果设置为true，VSCode会在当前打开的Python文件所在的目录中执行代码。这通常能解决大部分路径问题。
```
{
    "python.terminal.executeInFileDir": true
}
```
登录后复制
配置cwd（当前工作目录）： 如果你需要更精细的控制，可以使用cwd选项。例如，你想让所有Python代码都在项目根目录下运行，可以这样设置：
```
{
    "python.terminal.executeInFileDir": false,
    "terminal.integrated.cwd": "${workspaceFolder}"
}
```
登录后复制
${workspaceFolder}是VSCode的内置变量，代表当前打开的项目的根目录。

一览运营宝
一览“运营宝”是一款搭载AIGC的视频创作赋能及变现工具，由深耕视频行业18年的一览科技研发推出。

41

查看详情
使用Launch Configuration (launch.json)： 对于调试，launch.json文件非常重要。打开Debug视图（Ctrl+Shift+D 或 Cmd+Shift+D），点击“create a launch.json file”创建一个。在launch.json中，你可以设置cwd属性，指定调试器的工作目录。
```
{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Current File",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "cwd": "${workspaceFolder}"
        }
    ]
}
```
登录后复制
这个配置表示，调试当前文件时，工作目录设置为项目根目录。
绝对路径大法： 如果以上方法都不行，可以尝试使用绝对路径。但这通常不是一个好的解决方案，因为它不够灵活，而且在不同的机器上可能会失效。

如何确定正确的VSCode Python工作目录？

确定正确的工作目录需要根据你的项目结构和代码逻辑来判断。如果你的代码依赖于项目根目录下的文件，那么根目录就应该是工作目录。如果你的代码在一个子目录中，并且依赖于该子目录下的文件，那么该子目录就应该是工作目录。

VSCode工作目录设置后仍然出错怎么办？

如果设置了工作目录后仍然出错，可能是以下原因：

路径拼写错误： 仔细检查代码中的路径是否正确。
环境变量问题： 某些代码可能依赖于环境变量。确保环境变量已经正确设置。
第三方库问题： 有些第三方库可能对工作目录有特殊要求。查阅相关文档，了解如何正确配置。
权限问题： 确保VSCode有权限访问相关文件和目录。

如何在VSCode中调试Python代码并设置工作目录？

调试Python代码时，launch.json文件中的cwd属性非常重要。它可以让你在调试时指定工作目录。除了${workspaceFolder}，你还可以使用其他变量，例如${fileDirname}（当前文件所在的目录）。调试时，VSCode会使用你指定的目录作为工作目录，这对于调试涉及到文件操作的代码非常有用。

例如，如果你想让调试器在当前文件所在的目录中运行代码，可以这样设置：

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

登录后复制

以上就是VSCode运行Python代码出现路径错误怎么办？工作目录设置的详细内容，更多请关注php中文网其它相关文章！