Windows下Jupyter无法通过符号链接相对导入Python库问题排查

我来帮你分析下你遇到的这个符号链接导入问题，结合你的环境（Windows10/Python3.7.3/Jupyter），大概率是这几个原因导致的，对应的排查和修复方法如下：

可能的问题根源 #

• Windows符号链接权限不足：Windows创建真正的目录符号链接需要管理员权限，如果创建sym_link时没开管理员模式，它可能只是个普通快捷方式，Python无法识别为合法的模块目录。
• Jupyter工作目录不符：Jupyter的当前工作目录可能不是你以为的sourceCode，导致符号链接的相对路径失效，Python找不到目标库。
• Python 3.7对Windows符号链接的兼容性限制：早期Python版本在处理Windows符号链接时存在一些适配问题，尤其是嵌套目录的链接。
• 符号链接命名冲突：你把符号链接命名为sym_link，但导入时用import modifiedLibrary，这里的命名不匹配也会直接导致报错。

快速排查与修复步骤 #

1. 重新创建合法的符号链接
   打开管理员模式的命令提示符，进入sourceCode目录，执行以下命令创建正确的目录符号链接（注意命名要和你导入的库名一致）：

   mklink /D modifiedLibrary ../lib/modifiedLibrary/modifiedLibrary
   

   创建后执行dir命令，确认这个链接的类型是<SYMLINKD>，而不是普通的<DIR>或快捷方式。

2. 确认Jupyter工作目录
   在你的mainFile.ipynb开头添加这段代码，检查当前工作目录和符号链接的有效性：

   import os
   print("当前Jupyter工作目录:", os.getcwd())
   print("符号链接是否存在:", os.path.exists("./modifiedLibrary"))
   # 仅Windows可用，检查链接指向的真实路径
   if os.name == 'nt':
       print("符号链接指向路径:", os.readlink("./modifiedLibrary"))
   

   如果工作目录不是sourceCode，可以手动切换：

   os.chdir("你的sourceCode目录绝对路径")
   

3. 手动添加库路径到Python搜索列表
   如果符号链接还是不生效，可以跳过符号链接，直接把目标库的路径加入sys.path：

   import sys
   sys.path.append("../lib/modifiedLibrary")
   

   之后再执行import modifiedLibrary就应该能成功了。要是想永久生效，可以把这个路径添加到系统的PYTHONPATH环境变量中。

4. 对比正常运行设备的环境差异
   既然其他设备能正常运行，你可以在那边执行import sys; print(sys.path)，对比你本地的sys.path输出，看看是否缺少了某个关键路径，或者虚拟环境的配置不同。

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