Windows子进程因spawn机制重置工作目录和sys.path，不继承父进程路径修改，导致ModuleNotFoundError或FileNotFoundError；Linux用fork直接复制状态，故同一代码在Linux正常而Windows报错。
为什么Windows上子进程总找不到模块或配置文件
因为spawn机制下子进程会重置工作目录和sys.path，不继承父进程的路径修改。Linux用fork则直接复制全部状态，所以同一段代码在Linux能跑通，在Windows常报ModuleNotFoundError或FileNotFoundError。
排查时先确认子进程当前路径：
- 在worker函数开头加print(os.getcwd())和print(__file__)
- 检查相对路径是否基于__file__构造，比如用Path(__file__).parent / "config.yaml"而非"./config.yaml"
- 若依赖动态添加的sys.path（如IDE自动注入），需在worker内手动补全，或通过initializer统一注入
全局变量初始化为何在Windows子进程中失效
spawn不共享内存，所有模块级对象（日志器、数据库连接、缓存字典）在子进程中都是全新实例。你看到的“变量还在”，其实是Linux fork的错觉。
常见表现：
- logging.info()在子进程里没输出（主进程的basicConfig不生效）
- requests.Session()复用失败，每次新建连接
- 自定义单例类返回不同实例，状态不一致
解决方式：
- 子进程内显式调用初始化函数，如setup_logging()
- 对Pool使用initializer=init_worker参数统一处理
- 避免在模块顶层创建不可序列化对象（如threading.Lock、打开的文件句柄）——spawn时pickle会直接抛AttributeError
如何提前暴露平台兼容性问题
别等部署到Windows才踩坑。开发阶段就强制用spawn启动，能立刻发现隐藏缺陷。
Linux AI 服务器 — 将 Linux 服务器转换为本地 AI 推理集群。使用 systemd、NVIDIA CUDA 实现无头 Linux AI，零 GUI 开销。
在脚本最开头加：import multiprocessing; multiprocessing.set_start_method('spawn', force=True)
然后在Linux/macOS下运行。以下问题会立刻浮现：
- 未加if __name__ == '__main__':保护 → 无限递归创建进程
- worker函数定义在if块外但不在模块顶层（如嵌套在函数/类中）→ pickle失败
- 使用了Jupyter或交互式环境定义的函数 → 子进程找不到__main__中的符号
注意：PyInstaller打包后仍需此保护，否则exe双击运行即崩溃
DataLoader或Pool报错但无明确异常信息怎么办
Windows子进程异常默认不打印到主进程终端，常表现为静默退出、is_alive() == False或get(timeout=1)抛TimeoutError而非真实错误。
立即学习“Python免费学习笔记（深入）”；
必须主动捕获并落地日志：
- 在worker函数最外层包try/except，用logging.error(..., exc_info=True)写入文件
- 避免只用print()，它在子进程中可能被丢弃
- 测试时临时设Pool(, maxtasksperchild=1)，让每个任务跑在新进程里，便于定位状态污染问题
- 若用DataLoader(num_workers>0)，检查Dataset类是否定义在模块顶层，局部类/闭包函数无法被pickle反序列化
真正容易被忽略的是：模块导入顺序与条件导入在spawn下会变成硬性约束。比如某个库只在Windows下才import，但它被worker函数间接引用，而spawn子进程又不执行条件逻辑——这时连模块导入都失败，更别说后续执行了。
