Mac系统下从Google云端硬盘卷执行Python脚本的异常导入问题

我之前也碰到过类似的Google Drive File Stream诡异问题，结合你给出的例子，咱们来拆解下原因和可行的解决办法：

问题明确 #

先把场景再梳理一遍：

• Google文件流将云端硬盘挂载成Mac访达里的外部卷（路径/Volumes/GoogleDrive/My Drive/Project）
• 目录下有main.py和foo.py，直接运行python3 main.py会抛出ModuleNotFoundError: No module named 'foo'
• 但如果在导入foo前加一行print(os.listdir())——哪怕输出是空列表——导入居然就成功了

背后的原因 #

这其实是Google Drive文件流的网络文件系统特性和Python模块查找机制共同作用的结果：

1. Google Drive File Stream是网络挂载卷，不会像本地硬盘一样预加载所有目录内容，只有当你主动访问目录（比如执行ls或os.listdir()）时，才会从云端同步当前目录的文件列表到本地缓存。
2. Python查找模块时，依赖系统提供的目录文件条目。如果Google Drive还没同步出foo.py的信息，Python就会判定这个模块不存在。
3. os.listdir()会强制触发系统读取目录内容，哪怕同步延迟导致返回空列表，也已经启动了缓存加载动作。等后续执行import foo时，缓存里已经有foo.py的条目了，所以导入成功。

靠谱的解决办法 #

1. 手动将当前目录加入sys.path（最稳妥） #

直接告诉Python优先在当前目录查找模块，绕过系统缓存的不确定性：

import sys
import os

# 用脚本的绝对路径目录，避免从其他目录运行时出错
sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
import foo

print('hi')
print(foo.bar())

2. 使用Python相对导入 #

如果你的项目适合以模块方式运行，可以用相对导入：

from . import foo

print('hi')
print(foo.bar())

注意这种方式需要把脚本当作模块执行，命令要改成：

cd /Volumes/GoogleDrive/My\ Drive/Project
python3 -m main

3. 提前触发目录加载（临时 workaround） #

如果只是临时测试，也可以保留目录读取逻辑，但不建议长期依赖——毕竟网络延迟可能导致偶尔失效：

import os
# 不需要打印，只要触发目录读取动作即可
os.listdir()
import foo

print('hi')
print(foo.bar())

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