脚本说明#

功能特性#

扫描脚本所在目录下的代码文件（自动排除脚本自身，不会递归子目录）
自动识别文件语言并应用语法高亮
输出为 .docx Word 文档
统一使用 Consolas 等宽字体
默认字号约为 10.5pt
批量处理多个文件，逐个输出成功或失败结果

依赖要求#

Python 3.10+
pygments
spire.doc

安装命令：

1
pip install pygments spire.doc

当前支持的代码文件类型#

脚本当前会处理以下扩展名：

.m、.py、.c、.cpp、.java、.cs、.js、.ts、.go、.rs`

如果文件扩展名无法被 Pygments 正确识别，脚本会回退到 MatlabLexer 进行高亮处理。

使用方法#

1. 准备代码文件#

将需要转换的代码文件和 gen_word.py 放在同一个目录下。

例如：

1
code-to-word/
2
├── gen_word.py
3
├── main.py
4
├── utils.cpp
5
└── test.m

2. 运行脚本#

在 code-to-word 目录中执行：

1
python gen_word.py

3. 查看输出结果#

脚本会在当前目录下生成同名的 .docx 文件。

例如：

1
main.py    -> main.docx
2
utils.cpp  -> utils.docx
3
test.m     -> test.docx

脚本内容#

1
"""
2
批量将代码文件转为带语法高亮的 Word 文档
3
依赖安装: pip install pygments spire.doc
4
"""
5

6
import os
7
from pygments import highlight
8
from pygments.lexers import MatlabLexer, get_lexer_for_filename
9
from pygments.formatters import RtfFormatter
10
from spire.doc import Document, FileFormat
11

12

13
CODE_DIR = os.path.dirname(os.path.abspath(__file__))
14
FONT_SIZE = r"\fs21"  # 10.5pt ≈ fs21
15

16

17
def code_to_rtf(code: str, lexer) -> str:
18
    """将代码转为 RTF 格式（带语法高亮）"""
19
    formatter = RtfFormatter(fontface="Consolas")
20
    rtf_text = highlight(code, lexer, formatter)
21
    # 设置字体大小
22
    rtf_text = rtf_text.replace(r"\f0", r"\f0" + FONT_SIZE)
23
    return rtf_text
24

25

26
def process_file(filepath: str) -> None:
27
    """将单个代码文件转为 Word 文档"""
28
    basename = os.path.basename(filepath)
29
    filename_no_ext = os.path.splitext(basename)[0]
30
    output_path = os.path.join(CODE_DIR, filename_no_ext + ".docx")
31

32
    # 读取代码
33
    with open(filepath, "r", encoding="utf-8") as f:
34
        code = f.read()
35

36
    # 自动识别语言
37
    try:
38
        lexer = get_lexer_for_filename(basename)
39
    except Exception:
40
        lexer = MatlabLexer()
41

42
    # 转为 RTF
43
    rtf_text = code_to_rtf(code, lexer)
44

45
    # 生成 Word 文档（新建空文档，不加载源文件）
46
    doc = Document()
47
    section = doc.AddSection()
48
    para = section.AddParagraph()
49
    para.AppendRTF(rtf_text)
50
    doc.SaveToFile(output_path, FileFormat.Docx2016)
51
    doc.Close()
52

53
    print(f"[OK] {basename} -> {filename_no_ext}.docx")
54

55

56
def main():
57
    # 支持的代码文件扩展名
58
    extensions = {".m", ".py", ".c", ".cpp", ".java", ".cs", ".js", ".ts", ".go", ".rs"}
59
    # 排除自身
60
    self_name = os.path.basename(os.path.abspath(__file__))
61

62
    files = [
63
        f for f in os.listdir(CODE_DIR)
64
        if os.path.isfile(os.path.join(CODE_DIR, f))
65
        and f != self_name
66
        and os.path.splitext(f)[1].lower() in extensions
67
    ]
68

69
    if not files:
70
        print("未找到代码文件")
71
        return
72

73
    print(f"找到 {len(files)} 个代码文件，开始转换...\n")
74

75
    for f in sorted(files):
76
        filepath = os.path.join(CODE_DIR, f)
77
        try:
78
            process_file(filepath)
79
        except Exception as e:
80
            print(f"[FAIL] {f}: {e}")
81

82
    print(f"\n完成！文件保存在: {CODE_DIR}")
83

84

85
if __name__ == "__main__":
86
    main()