如何在Python中添加私有模块目录至系统路径？Windows环境求助

我在Windows 10系统上使用Python 3.10.9和Visual Studio 1.18，想把存放自定义模块（包含函数与类，供其他模块调用）的私有库添加到Python系统路径，实现类似scikit-learn的调用方式。

我尝试了以下代码：

import sys
sys.path.append('E:\\machine_learning\\my_lib')

但运行下面的检查代码时，显示库未被导入：

import sys      
def check_library_import(library_name):     
    if library_name in sys.modules:     
        print(f"La libreria '{library_name}' è stata correttamente importata.")     
    else:       
        print(f"La libreria '{library_name}' non è stata importata.")       
        # Sostituisci 'lib_madre' con il nome effettivo del tuo pacchetto madre
library_name = 'E:\machine_learning\my_lib'     
check_library_import(library_name)      

核心问题 #

你的检查逻辑和操作存在两处关键错误：

1. sys.modules存储的是已导入的模块/包名称（比如sklearn、numpy），不是文件路径，你传入完整路径肯定查不到对应条目。
2. 把路径加到sys.path只是让Python知道去哪里查找模块，但你还得显式导入对应的包/模块，它才会被加载到sys.modules中。

正确操作步骤 #

1. 将自定义文件夹转为合法Python包
   在E:\machine_learning\my_lib文件夹下创建一个__init__.py文件（空文件即可），这样Python才会把该文件夹识别为可导入的包。
   假设你的my_lib里有一个存放函数和类的模块文件my_tools.py。

2. 正确添加路径并导入模块

   import sys
   # 注意：添加的是my_lib所在的父级路径，不是my_lib本身
   sys.path.append('E:\\machine_learning')
   # 像导入第三方库一样导入你的包
   import my_lib
   # 或者直接导入包里的具体模块
   from my_lib import my_tools
   

3. 修正检查代码
   修改检查函数，传入模块/包的名称而非路径：

   import sys      
   def check_library_import(module_name):     
       if module_name in sys.modules:     
           print(f"模块 '{module_name}' 已成功导入。")     
       else:       
           print(f"模块 '{module_name}' 未导入。")       
   
   # 检查my_lib包是否导入
   check_library_import('my_lib')
   # 检查具体模块
   check_library_import('my_lib.my_tools')
   

4. 永久添加路径（可选，更便捷）
   每次运行代码手动加路径太繁琐，推荐两种永久方案：

   • 用pip安装为可编辑包：在E:\machine_learning\my_lib下创建setup.py（参考Python官方包结构模板编写），然后在终端运行pip install -e .，之后你就能像导入scikit-learn一样直接import my_lib，无需手动添加路径。
   • 使用.pth文件：找到Python安装目录下的site-packages文件夹，创建一个my_lib.pth文件，里面写入E:\machine_learning，保存后Python每次启动都会自动把该路径加入sys.path。

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