PyCharm 不支持直接导出 PDF 代码文档，需通过系统虚拟打印机间接实现；专业 PDF 文档须借助 Sphinx 等外部工具链生成，且需注意行号、主题、换行等导出细节。

PyCharm 本身不支持直接导出 PDF 代码文档

PyCharm 没有内置的「导出为 PDF」菜单项，也不是文档生成工具。你看到的“导出 PDF”功能，实际是通过打印预览 + 系统虚拟打印机（如 macOS 的“另存为 PDF”，Windows 的 Microsoft Print to PDF）间接实现的——本质是把编辑器界面“截图式打印”，而非生成结构化文档。

用 Print to PDF 导出当前文件的可读 PDF

这种方式适合快速存档单个 .py 文件，但格式简单、无语法高亮保留风险、不带目录或交叉引用：

• 打开目标文件，在 PyCharm 中按 Ctrl+P（Windows/Linux）或 Cmd+P（macOS）调出打印对话框
• 选择打印机为 Microsoft Print to PDF（Windows）或 Save as PDF（macOS）
• 关键设置：勾选 “Print background colors and images”（否则 Syntax Highlighting 会丢失）
• 字体可能被缩放变形，建议在 Settings > Editor > Font 中设为等宽且大小适中（如 Fira Code 12），再打印

真正生成专业 PDF 文档得靠外部工具链

如果你需要含函数说明、模块关系图、自动索引的 PDF，必须脱离 PyCharm UI，走标准文档流程。主流做法是用 sphinx + readthedocs 风格生成：

PyCharm 2026.2

PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包，下载地址指向官方 Windows 安装包直链，可用于旧项目兼容、版本回退和环境测试。

下载

• 在项目根目录运行 sphinx-quickstart 初始化文档结构
• 用 sphinx-autodoc 插件从源码注释（"""docstring"""）提取 API 文档
• 配置 conf.py 启用 sphinx.ext.viewcode 和 sphinx_rtd_theme
• 最终执行 make latexpdf（需系统安装 LaTeX）或 make pdf（推荐用 rst2pdf 后端，更轻量）

注意：sphinx 不识别 PyCharm 的断点/TODO 注释，只认标准 docstring 和 :param: 这类 reStructuredText 标记。

导出时容易丢内容的三个坑

无论用打印还是 Sphinx，这几处常被忽略：

• PyCharm 默认关闭行号和折叠标记的打印 —— 必须在打印设置里手动勾选 Print line numbers 和 Print code folding indicators（如果需要）
• 深色主题下直接打印 PDF 可能导致文字不可读，建议临时切到 Light Theme 或在 Settings > Editor > Color Scheme 中调整背景色为浅灰
• 长行代码默认不换行，PDF 中会溢出页面 —— 打印前先启用 Soft Wraps（右键编辑区 → Soft-wrap），或在 Sphinx 中配置 maximum_signature_line_length = 88

PDF 不是代码归档的终点，而是交付物的一环；真正要让别人看懂，得先写清楚 docstring 和 type hints，工具只是补漏。