为何无法找到已以可编辑模式安装的Python helloworld包？

问题场景 #

Windows系统下搭建如下目录结构：

• dir1包含helloworld包和setup.py，附带独立虚拟环境venv
• dir2包含测试脚本app2.py，附带独立虚拟环境venv

按以下步骤操作后出现异常：

1. 在dir2的虚拟环境中执行pip install -e C:\Users\TC\temp\editable\dir1，以可编辑模式安装helloworld包
2. pip list显示包已安装，但运行app2.py提示找不到helloworld包，VS Code中导入语句下方出现黄色波浪线

可能原因与解决步骤 #

1. 确认虚拟环境激活状态与Python解释器路径 #

• 确保dir2的虚拟环境已正确激活：命令行前缀需显示(venv)
• 执行以下命令验证Python解释器路径是否指向dir2的虚拟环境：

  where python
  

  输出应包含C:\Users\TC\temp\editable\dir2\venv\Scripts\python.exe，若显示其他路径，说明未正确激活环境，需重新执行激活命令。

2. 检查可编辑安装的有效性 #

执行以下命令查看包的安装信息：

pip show helloworld

• 确认Location字段指向dir1/helloworld目录，且带有(editable)标记
• 若输出异常，重新执行可编辑安装命令，可将Windows路径替换为正斜杠避免转义问题：

  pip install -e C:/Users/TC/temp/editable/dir1
  

3. 确保当前虚拟环境安装setuptools #

可编辑安装依赖setuptools，需在dir2的虚拟环境中执行：

pip install --upgrade setuptools

（注：原提示中提到在dir1的虚拟环境安装setuptools仅对dir1环境有效，dir2环境需单独安装）

4. 配置VS Code的Python解释器 #

VS Code可能未自动识别dir2的虚拟环境：

1. 按Ctrl+Shift+P打开命令面板
2. 输入Python: Select Interpreter
3. 选择dir2/venv/Scripts/python.exe作为当前工作区的解释器
4. 若仍有提示，执行命令面板中的Python: Restart Language Server或重启VS Code

5. 验证交互模式下的导入 #

在激活的dir2虚拟环境中打开Python交互终端：

python

输入导入语句测试：

from helloworld.hello import say_hello
print(say_hello())

• 若交互模式正常，说明代码本身无问题，仅需解决VS Code的缓存或解释器配置问题
• 若交互模式仍报错，检查dir1的setup.py：确保find_packages()能识别helloworld包（该包需包含__init__.py，空文件即可）

6. 排查Windows权限问题 #

若以上步骤无效，尝试以管理员身份打开命令提示符，重新激活dir2的虚拟环境并执行可编辑安装命令，避免权限不足导致的egg-link文件创建失败。

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