Vscode 中 python模块的导入问题

查看当前Python解释器的模块搜索路径import syspaths sys.path# 遍历当前Python解释器的模块搜索路径列表for path in paths:print(path)终端输出信息(base) PS E:\Projects\OCR-sdk (D:\ProgramData\Anaconda3\shell\condabin\conda-hook.ps1) ; (conda activate base)(base) PS E:\Projects\OCR-sdk D:\ProgramData\Anaconda3\python.exe e:/Projects/OCR-sdk/tests/path.pye:\Projects\OCR-sdk\testsD:\ProgramData\Anaconda3\python313.zipD:\ProgramData\Anaconda3\DLLsD:\ProgramData\Anaconda3\LibD:\ProgramData\Anaconda3D:\ProgramData\Anaconda3\Lib\site-packagesD:\ProgramData\Anaconda3\Lib\site-packages\win32D:\ProgramData\Anaconda3\Lib\site-packages\win32\libD:\ProgramData\Anaconda3\Lib\site-packages\Pythonwin(base) PS E:\Projects\OCR-sdk路径仅包含当前python文件、系统环境变量和当前python环境目录当前项目根目录不在Python的模块搜索路径中时所以跨目录的模块导入会失败。解决方法通过配置VSCode的集成终端环境变量将项目根目录添加到PYTHONPATH中让Python解释器能够正确找到项目中的所有模块。配置步骤修改用户配置通过ctrlshiftp打开用户配置文件也可以修改当前项目的工作区配置文件\.vscode\settings.json在配置文件中添加如下配置{terminal.integrated.env.windows: {// 设置 PYTHONPATH 环境变量为当前工作区根目录PYTHONPATH: ${workspaceFolder}}}配置说明terminal.integrated.env.windows针对Windows系统的集成终端环境变量配置PYTHONPATHPython解释器用于搜索模块的环境变量${workspaceFolder}VSCode内置变量表示当前工作区的根目录路径其他平台配置windows/Linux/macOS配置{terminal.integrated.env.windows: {PYTHONPATH: ${workspaceFolder}},terminal.integrated.env.linux: {PYTHONPATH: ${workspaceFolder}},terminal.integrated.env.osx: {PYTHONPATH: ${workspaceFolder}}}验证配置是否生效再次查看模块搜索路径pythonimport syspaths sys.pathfor path in paths:print为了防止修改后未立即生效可以在新终端里再次测试或者直接重启Vscode(base) PS E:\Projects\OCR-sdk D:\ProgramData\Anaconda3\python.exe e:/Projects/OCR-sdk/tests/path.pye:\Projects\OCR-sdk\testsE:\Projects\OCR-sdkD:\ProgramData\Anaconda3\python313.zipD:\ProgramData\Anaconda3\DLLsD:\ProgramData\Anaconda3\LibD:\ProgramData\Anaconda3D:\ProgramData\Anaconda3\Lib\site-packagesD:\ProgramData\Anaconda3\Lib\site-packages\win32D:\ProgramData\Anaconda3\Lib\site-packages\win32\libD:\ProgramData\Anaconda3\Lib\site-packages\Pythonwin如果配置成功那么项目根目录例如E:\Projects\OCR-sdk应该出现在sys.path的输出中。注意重启终端修改配置后需要重新打开集成终端才能生效多项目支持每个项目可以有独立的.vscode/settings.json配置路径分隔符在Windows中使用分号;分隔多个路径在macOS/Linux中使用冒号:扩展配置如果需要添加多个路径到PYTHONPATH{terminal.integrated.env.windows: {PYTHONPATH: ${workspaceFolder};${workspaceFolder}\\src;${workspaceFolder}\\lib}}