### 问题分析 在 VSCode 中运行 Python 代码时，如果出现文件路径问题（例如找不到文件或同目录下存在同名文件），通常与 `PYTHONPATH` 设置、工作目录配置以及模块导入方式有关。以下将详细分析并提供解决方案。 --- ### 解决方案 #### 1. 配置 `PYTHONPATH` 确保 VSCode 的环境变量中正确设置了 `PYTHONPATH`，以便 Python 能够找到所需的模块或文件。可以通过以下方法设置： - **在代码中显式添加路径**： 如果其他方法无效，可以在代码开头手动插入路径[^1]： ```python import sys sys.path.insert(0, r'D:\xxx\minisim\minibin') ``` - **通过 `launch.json` 配置**： 在 `.vscode/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}/src;${workspaceFolder}/mock" } } ] } ``` 这样可以确保运行时能够识别 `src` 和 `mock` 目录下的模块[^1]。 --- #### 2. 检查工作目录设置 VSCode 的工作目录可能会影响文件路径的解析。如果未正确设置工作目录，可能会导致无法找到文件。解决方法如下： - **通过 `launch.json` 设置工作目录**： 在 `launch.json` 中添加 `cwd` 字段，指定运行时的工作目录： ```json { "version": "0.2.0", "configurations": [ { "name": "Python: Current File", "type": "python", "request": "launch", "program": "${file}", "console": "integratedTerminal", "cwd": "${workspaceFolder}" } ] } ``` 确保 `${workspaceFolder}` 是项目的根目录，或者根据需要调整为子目录[^3]。 --- #### 3. 处理同名文件冲突 当项目中存在同名文件时，可以通过明确指定模块路径来避免冲突。例如： - **使用绝对导入**： 假设需要分别导入 `xxx/src/com/dvsnier/asc/xxx.py` 和 `xxx/mock/com/dvsnier/asc/yyy.py`，可以通过以下方式实现[^2]： ```python # 导入 src 下的 xxx.py from com_dvsnier_xxx.xxx import some_function as src_function # 导入 mock 下的 yyy.py from com_dvsnier_xxx_mock.yyy import another_function as mock_function ``` - **命名空间包**： 如果项目使用了命名空间包，确保每个模块的命名空间唯一。例如，在 `namespace_package=['com_dvsnier_xxx']` 和 `namespace_package=['com_dvsnier_xxx_mock']` 的基础上，分别定义不同的模块路径。 --- #### 4. 检查文件路径编码问题 如果文件路径中包含中文字符，可能会导致路径解析失败。建议将文件路径转换为 Unicode 或使用原始字符串表示法。例如： ```python file_path = r'xxx\mock\com\dvsnier\asc\yyy.py' ``` --- ### 示例代码 以下是一个完整的示例，展示如何在 VSCode 中正确配置并导入不同目录下的同名模块： ```python import sys sys.path.insert(0, r'xxx\src') # 添加 src 目录到 PYTHONPATH sys.path.insert(0, r'xxx\mock') # 添加 mock 目录到 PYTHONPATH # 导入 src 下的 xxx.py from com.dvsnier.asc.xxx import some_function # 导入 mock 下的 yyy.py from com.dvsnier.asc.yyy import another_function # 测试函数 print(some_function()) print(another_function()) ``` --- ###