### 解决方案 在 VSCode 中正确配置 Python 模块导入路径以实现跨文件引用，可以通过以下方法完成： #### 方法一：调整 `PYTHONPATH` 环境变量 VSCode 提供了一种简单的方式来修改运行环境中的 `PYTHONPATH`。可以在 `.env` 文件或者调试配置中指定项目的根目录作为模块搜索路径的一部分。 1. **创建或编辑 `.env` 文件** 在项目根目录下创建一个名为 `.env` 的文件，并添加以下内容： ```plaintext PYTHONPATH=${workspaceFolder} ``` `${workspaceFolder}` 是 VSCode 的内置变量，表示当前工作区的根目录[^1]。 2. **更新 launch.json 配置** 如果使用的是调试模式，也可以直接在 `launch.json` 文件中设置 `env` 参数来扩展 `PYTHONPATH`： ```json { "version": "0.2.0", "configurations": [ { "name": "Python: Current File", "type": "python", "request": "launch", "program": "${file}", "console": "integratedTerminal", "env": { "PYTHONPATH": "${workspaceFolder}" } } ] } ``` #### 方法二：动态修改 `sys.path` 如果不想依赖于外部工具链，可以直接在代码中手动将项目根目录或其他子目录添加到 `sys.path` 中。这种方法适用于临时性的开发需求。 以下是具体的代码示例： ```python import os import sys # 动态获取当前文件所在的目录并将其父级目录加入到 sys.path current_dir = os.path.dirname(os.path.abspath(__file__)) parent_dir = os.path.dirname(current_dir) sys.path.append(parent_dir) # 此时可以正常导入同级或上级目录中的模块 from v0 import some_function some_function() ``` 上述代码的作用是将当前文件所在目录的上一级目录添加到 `sys.path` 列表中，从而允许导入位于该路径下的模块[^2]。 #### 方法三：利用相对导入 当多个 Python 文件属于同一个包结构时，推荐使用相对导入的方式。假设有一个这样的项目结构： ``` project/ │ ├── main.py └── package/ ├── __init__.py └── module_a.py ``` 在这种情况下，在 `main.py` 中可以通过以下方式导入 `module_a`： ```python from package.module_a import function_name function_name() ``` 而在 `package/module_a.py` 中，则可以这样进行内部调用： ```python from .another_module_in_package import another_function another_function() ``` 注意，相对导入仅限于在同一包内的不同模块间使用[^3]。 --- ### 总结 为了确保 VSCode 中 Python 文件之间的顺利引用，可以选择通过配置 `PYTHONPATH` 或者动态调整 `sys.path` 来解决问题。同时，合理设计包结构并通过标准的相对/绝对导入语法也能有效减少此类问题的发生频率。 ---