Jemdoc无法编译求助：适配Python 3.13及macOS环境问题
2026-6-12
Jemdoc在Python 3.13下编译失败的解决办法
降级Python版本：Jemdoc的Python3分支停更已6年，对Python3.10+兼容性极差，降级到Python3.9或3.10是最稳妥的方案。用pyenv管理多版本：
- 安装pyenv：
brew install pyenv - 安装兼容版本：
pyenv install 3.9.18 - 在项目目录设置局部版本：
pyenv local 3.9.18 - 验证版本后执行编译命令：
python jemdoc.py yourfile.jemdoc
- 安装pyenv：
替换为维护中的fork分支：部分社区fork的Jemdoc分支针对高版本Python做了修复，替换现有
jemdoc.py文件后可尝试编译。手动修复语法兼容问题：若不想降级，可针对性修复常见报错：
- 确保所有
print语句改为函数形式（print(content)而非print content） - 将
dict.iteritems()替换为dict.items() - 把
except Exception, e语法改为except Exception as e - 打开文件时明确指定编码：
open(filename, encoding="utf-8")
- 确保所有
替代方案：若以上方法无效，可迁移到MkDocs、Hugo等现代静态站点工具，或用转换工具将Jemdoc文件转为Markdown后再构建。
目前仍有学术圈用户在使用Jemdoc，主流的运行方式是降级Python版本或使用兼容的fork分支。
内容的提问来源于stack exchange，提问作者Tchaikovski
相关产品推荐
相关产品推荐
