如何配置Python路径，使其识别指定目录的包并保留原有配置？

问题原因 #

你通过pip.ini的target参数指定了包的安装目录，但Python的模块搜索路径默认不包含这个目录，导致导入时找不到包。之前添加P:\PYTHONPACKAGE\bin到PATH无效，是因为模块文件并不在bin目录里，而是直接存放在P:\PYTHONPACKAGE根目录下。

具体解决方法 #

方法1：设置PYTHONPATH环境变量（全局生效） #

• 打开Windows系统环境变量设置：右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
• 在「系统变量」区域点击「新建」，变量名填PYTHONPATH，变量值填P:\PYTHONPACKAGE
• 点击确定保存，重启VSCode和Jupyter Notebook后设置才会生效
• 验证：在Jupyter中运行以下代码，确认路径已添加：

import sys
print([p for p in sys.path if "PYTHONPACKAGE" in p])

方法2：创建.pth文件（永久生效，推荐） #

• 找到Python默认的site-packages目录，Python3.11的路径一般为：
  C:\Users\[你的用户名]\AppData\Local\Programs\Python\Python311\Lib\site-packages
• 在该目录下新建一个文本文件，命名为custom_packages.pth（后缀必须是.pth，前缀可自定义）
• 打开文件，写入一行内容：P:\PYTHONPACKAGE，保存后关闭
• 重启VSCode和Jupyter，Python会自动加载这个目录下的所有模块

方法3：临时添加路径（仅当前会话有效） #

如果只是临时测试，可在Jupyter代码开头添加：

import sys
sys.path.append("P:\\PYTHONPACKAGE")

添加后即可导入该目录下的包，但每次重启Notebook都需要重新执行这段代码

额外检查 #

• 确认pip安装的包确实在P:\PYTHONPACKAGE下：运行pip install numpy后，查看输出中的「Installing collected packages」部分，确认安装路径是P:\PYTHONPACKAGE
• 避免混淆Python环境：确保VSCode左下角选中的解释器是你使用的Python3.11.3

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