Docker运行Python+Hunspell代码报错：找不到libhunspell-1.3.so.0共享对象文件

这个问题的根源很明确：cyhunspell是Hunspell的Python绑定，它依赖系统层面安装的Hunspell原生库文件，而你用的官方python:3镜像（基于Debian/Ubuntu）默认并没有预装这个库，所以运行时会抛出找不到.so文件的错误。

修复后的Dockerfile #

直接在构建过程中添加系统级Hunspell库的安装步骤即可，修改后的Dockerfile如下：

FROM python:3
ADD main.py /
# 安装系统Hunspell库，同时清理缓存减小镜像体积
RUN apt-get update && apt-get install -y --no-install-recommends hunspell \
    && rm -rf /var/lib/apt/lists/*
RUN pip install cyhunspell
CMD [ "python", "main.py" ]

为什么这样能解决？ #

• apt-get install hunspell会自动安装所需的libhunspell共享库（包括你报错里的libhunspell-1.3.so.0或对应版本），让cyhunspell的C扩展能找到依赖。
• 加上--no-install-recommends和清理/var/lib/apt/lists/*是为了避免安装不必要的依赖，控制镜像大小。

关于基础镜像的疑问：必须用Linux吗？ #

严格来说不是必须，但强烈推荐用Linux基础镜像：

• Hunspell确实有Windows版本，但cyhunspell的预编译包对Linux环境的支持更完善，Docker的Linux镜像生态也远优于Windows容器。
• 如果硬要用Windows镜像，你需要手动安装Windows版的Hunspell库，并确保cyhunspell能正确关联到它，但这个过程会比Linux复杂很多，容易踩坑。
• 另外，如果你想尝试更轻量化的镜像，可以用python:3-alpine，但需要用apk add hunspell来安装库，同时可能还要额外安装编译依赖（比如gcc、musl-dev），因为Alpine用的是musl libc，部分Python扩展需要重新编译，反而不如Debian/Ubuntu镜像省心。

测试一下修改后的镜像，你的代码应该能正常输出True了。

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