先确认下你的项目结构应该是这样的：

your_project/
├── app.py
├── hello.py
└── world.py

一、同目录子模块的正确导入方式 #

分两种场景选择合适的导入方式：

1. 直接运行脚本的场景（比如执行python app.py） #

这种情况下，Python会自动把app.py所在的目录加入到sys.path里，直接导入就行：

• 在app.py中：

  import hello
  import world
  
  # 调用模块里的功能，比如
  hello.say_hello()
  world.say_world()
  

• 在world.py中调用hello模块时，同样直接导入：

  import hello
  
  def say_world():
      print(f"World! {hello.get_greeting()}")
  

  这种方式简单直接，运行app.py时完全没问题。

2. 作为Python包被外部导入的场景 #

如果你的项目需要被其他Python代码导入（比如from your_project import hello），推荐用相对导入，在world.py中这样写：

from . import hello

注意：这种方式下不能直接运行world.py（会报"Attempted relative import in non-package"错误），必须通过app.py或者作为包导入来运行。

另外，建议在项目根目录创建一个空的__init__.py文件，这样Python会明确把这个目录识别为一个包，不管是运行还是导入都会更顺畅。

二、解决VSCode的"Unable to import module"报错 #

程序能跑但编辑器报错，本质是VSCode的Python分析器没有正确识别你的项目根目录作为Python路径。试试下面这几个方法：

• 方法1：确认Python解释器和运行环境一致
  点击VSCode右下角的Python版本号，选择你运行程序时用的那个解释器（比如虚拟环境里的Python）。有时候VSCode默认用了全局解释器，和你运行的环境不一致就会导致识别错误。

• 方法2：用.env文件添加路径
  在项目根目录创建一个.env文件，写入一行：

  PYTHONPATH=./
  

  VSCode会自动读取这个文件，把当前目录加入Python路径，分析器就能找到同目录的模块了。

• 方法3：配置VSCode的分析路径
  打开VSCode设置（快捷键Ctrl+,），搜索python.analysis.extraPaths，点击"编辑 in settings.json"，添加项目根目录：

  {
      "python.analysis.extraPaths": [
          "${workspaceFolder}"
      ]
  }
  

  ${workspaceFolder}会自动对应你当前打开的项目文件夹，不用写死路径。

• 方法4：标记源码根目录
  在VSCode资源管理器里右键点击项目根目录，选择"将文件夹添加到工作区"，或者在Python扩展的设置里把该目录标记为源码根。这样VSCode会优先从这个目录解析模块。

试完这些方法，VSCode的导入提示应该就正常了。

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