vs code 中无法从同目录文件导入模块，通常因 python 解释器未将当前工作目录加入 sys.path，需通过配置环境变量、创建可安装包或正确使用 -m 方式运行来解决。

在 Python 中，模块导入依赖于 sys.path —— 一个决定“从哪找模块”的路径列表。Python 默认不会自动将当前工作目录（Current Working Directory, CWD）加入 sys.path，尤其在 VS Code 中，即使 .py 文件与被导入文件位于同一文件夹，若执行方式或解释器环境配置不当，from test_file import Rock 仍会触发 Import "test_file" could not be resolved（Pylance 报错）或运行时 ModuleNotFoundError。

✅ 正确做法：优先使用 -m 模块模式运行

确保项目结构清晰，并以包（package）形式组织代码：

my_project/
├── __init__.py      # 使目录成为 Python 包
├── main.py          # 入口脚本（含 from test_file import Rock）
└── test_file.py     # 定义 class Rock

⚠️ 关键前提：main.py 不能直接双击运行或用 python main.py 执行，而应从 my_project 的父目录下，以模块方式调用：

cd ..                    # 进入 my_project 的上一级
python -m my_project.main

此时 Python 将 my_project 视为顶层包，main.py 中的 from test_file import Rock（或更规范的 from .test_file import Rock）才能被正确解析。

✅ 替代方案（按推荐度排序）

⚠️ 常见误区澄清

• from .test_file import Rock 是相对导入，仅在包内模块中有效，不能用于直接运行的脚本（如 python main.py），否则报 SystemError: Parent module '' not loaded。
• macOS 系统更新通常不直接影响 Python 导入机制，但可能重置终端默认 shell 或 VS Code 的 Python 解释器选择，建议检查 VS Code 左下角 Python 解释器路径是否指向预期虚拟环境。
• Pylance 报错（reportMissingImports）是静态分析警告，有时与实际运行结果不一致；可先运行脚本验证是否真报错，再针对性修复。

✅ 一句话总结

不要依赖“同目录即自动可导入”，而应主动构建包结构 + 使用 python -m 运行，或通过 pip install -e . 将项目注册为可导入包——这是符合 Python 最佳实践、跨平台稳定、且被 VS Code/Pylance 完全支持的标准方案。

# python  # vscode  # js  # json  # mac  # ai  # macos  # 环境变量  # 虚拟环境  # vs code  # 环境配置  # pip  # Directory  # 报错  # 安装包  # 这是  # 均可  # 双击  # 句话  # 仅限  # 或用  # 仍会  # 可先 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571 】

相关推荐： 如何用已有域名快速搭建网站？  Laravel如何实现用户角色和权限系统_Laravel角色权限管理机制  如何在阿里云虚拟主机上快速搭建个人网站？  详解Android中Activity的四大启动模式实验简述  Laravel怎么使用Intervention Image库处理图片上传和缩放  Win11怎么恢复误删照片_Win11数据恢复工具使用【推荐】  Win11怎么开启自动HDR画质_Windows11显示设置HDR选项  原生JS获取元素集合的子元素宽度实例  韩国代理服务器如何选？解析IP设置技巧与跨境访问优化指南  Laravel怎么多语言本地化设置_Laravel语言包翻译与Locale动态切换【手册】  如何用西部建站助手快速创建专业网站？  Laravel怎么配置S3云存储驱动_Laravel集成阿里云OSS或AWS S3存储桶【教程】  如何快速搭建高效服务器建站系统？  谷歌Google入口永久地址_Google搜索引擎官网首页永久入口  php后缀怎么变mp4格式错误_修改扩展名提示格式不对怎么办【技巧】  Laravel如何实现数据库事务？（DB Facade示例）  如何在阿里云香港服务器快速搭建网站？  JavaScript如何实现继承_有哪些常用方法  Laravel如何实现API速率限制？（Rate Limiting教程）  googleplay官方入口在哪里_Google Play官方商店快速入口指南  油猴 教程,油猴搜脚本为什么会网页无法显示？  Laravel策略(Policy)如何控制权限_Laravel Gates与Policies实现用户授权  HTML5空格和nbsp有啥关系_nbsp的作用及使用场景【说明】  详解阿里云nginx服务器多站点的配置  Laravel定时任务怎么设置_Laravel Crontab调度器配置  Laravel中Service Container是做什么的_Laravel服务容器与依赖注入核心概念解析  如何在云主机快速搭建网站站点？  详解vue.js组件化开发实践  移动端脚本框架Hammer.js  Google浏览器为什么这么卡 Google浏览器提速优化设置步骤【方法】  Laravel如何实现模型的全局作用域？（Global Scope示例）  如何在搬瓦工VPS快速搭建网站？  Laravel如何实现多对多模型关联？（Eloquent教程）  Python高阶函数应用_函数作为参数说明【指导】  Laravel storage目录权限问题_Laravel文件写入权限设置  canvas 画布在主流浏览器中的尺寸限制详细介绍  edge浏览器无法安装扩展 edge浏览器插件安装失败【解决方法】  免费制作统计图的网站有哪些,如何看待现如今年轻人买房难的情况？  linux写shell需要注意的问题(必看)  微信小程序制作网站有哪些,微信小程序需要做网站吗？  网站设计制作书签怎么做,怎样将网页添加到书签/主页书签/桌面？  PHP怎么接收前端传的文件路径_处理文件路径参数接收方法【汇总】  Laravel Admin后台管理框架推荐_Laravel快速开发后台工具  如何用PHP工具快速搭建高效网站？  Laravel中DTO是什么概念_在Laravel项目中使用数据传输对象(DTO)  Laravel Livewire是什么_使用Laravel Livewire构建动态前端界面  ChatGPT常用指令模板大全 新手快速上手的万能Prompt合集  通义万相免费版怎么用_通义万相免费版使用方法详细指南【教程】  微信小程序 require机制详解及实例代码  php结合redis实现高并发下的抢购、秒杀功能的实例