Python导入自定义函数报NameError，疑VSCode配置问题求解决

问题分析 #

你遇到的NameError本质是脚本执行时的工作目录与相对路径不匹配，导致sys.path.append('../../../../utils')没有正确指向driver.py所在的目录。同事能正常运行，大概率是他们VSCode的默认工作目录设置为spiders根目录，而你的工作目录是其他层级（比如项目根目录），导致相对路径计算错误。

解决方案 #

1. 使用绝对路径添加模块搜索路径（最稳妥） #

避免相对路径的不确定性，用os.path模块动态生成utils目录的绝对路径：

import sys
import os

# 获取当前脚本的绝对路径
script_path = os.path.abspath(__file__)
# 获取脚本所在目录
script_dir = os.path.dirname(script_path)
# 拼接utils目录的绝对路径并标准化
utils_dir = os.path.normpath(os.path.join(script_dir, '../../../../utils'))
sys.path.append(utils_dir)

from driver import print_on_console

print_on_console('Hello world!')

这种方式不管在哪个目录执行脚本，都能准确定位到utils目录。

2. 配置VSCode的运行工作目录 #

修改VSCode的launch.json，将运行时的工作目录设置为当前脚本所在目录：

1. 打开VSCode的运行和调试面板（Ctrl+Shift+D）
2. 点击"创建launch.json文件"，选择"Python"环境
3. 在生成的launch.json中，为Python: Current File配置添加"cwd": "${fileDirname}"：

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

这样运行脚本时，工作目录就是short.py所在的runnable目录，../../../../utils就能正确指向目标目录。

3. 将spiders目录设为Python源码根目录 #

让VSCode自动识别模块路径，无需手动修改sys.path：

1. 在VSCode的资源管理器中，右键点击spiders目录
2. 选择"Add Folder to Python Path"
3. 修改short.py的导入语句为绝对导入：

from utils.driver import print_on_console

print_on_console('Hello world!')

4. 检查VSCode Python扩展的额外路径设置 #

如果上述方法无效，手动添加utils目录到VSCode的Python分析路径：

1. 打开VSCode设置（Ctrl+,）
2. 搜索"Python > Analysis: Extra Paths"
3. 点击"编辑 in settings.json"，添加utils目录的绝对路径，比如：

{
    "python.analysis.extraPaths": [
        "D:/projects/company/spiders/utils"
    ]
}

内容的提问来源于stack exchange，提问作者NukeSkull