用 LaTeX 写情书？一个程序员给女朋友的“硬核”浪漫开源项目
> 一个用纯 LaTeX 编写的情书/表白文档模板，让程序员用最严谨的排版表达最不严谨的爱意。
---
## 一、项目初印象：当理工男决定写情书
在 GitHub 上，Star 数超过 3000 的项目通常意味着它解决了某个普遍的技术痛点，或者提供了某种惊艳的框架。但 `HEJustinSun/my-girlfriend-jingtian-latex` 这个项目，却是一个异类——它没有一行 JavaScript，没有 API 调用，没有机器学习模型，它只有一堆 `.tex` 文件，和一个程序员对女朋友的深情。
这个项目本质上是一个 **LaTeX 情书模板**，作者用 TeX 语言编写了一份结构完整、排版精美、充满书卷气的表白文档。它既不是工具库，也不是框架，而是一份**可以直接编译成 PDF 的源代码**。你只需要修改其中的文字，就能得到一份独一无二的、用学术论文排版标准写出来的情书。
项目语言是 TeX，Star 数却高达 3775，这本身就说明了一个有趣的现象：**在技术社区里，情感表达也可以成为硬核爱好者的共同语言**。
---
## 二、它解决了什么痛点？
在传统认知中，写情书是一件感性、随意、充满手写温度的事情。但程序员（尤其是理工科背景的开发者）往往面临几个尴尬：
1. **字丑**：手写情书可能连自己都认不出写了什么。
2. **排版强迫症**：Word 里调整行距、对齐、页边距会让人崩溃，而 LaTeX 天然解决这些。
3. **表达方式**：程序员习惯用代码和逻辑表达世界，但面对情感时往往词穷。这个项目给出了一个“结构化”的情感表达范式——像写论文一样写情书，分章节、分小节、有证明、有结论。
4. **浪漫的仪式感**：当对方收到一份排版精美的 PDF 情书，而不是微信里一段文字时，那种“你为我编译了一份文档”的仪式感是无可替代的。
这个项目正是为了满足这种“理工科浪漫”而生的：它提供了一套完整的 LaTeX 源码，你只需要改文字，就能生成一份专业级别的表白文档。
---
## 三、怎么用？从安装到编译
### 3.1 环境准备
首先你需要一个 LaTeX 发行版。推荐使用 **TeX Live**（Linux/macOS）或 **MiKTeX**（Windows）。如果你不想安装完整版，也可以用在线编辑器如 Overleaf。
bash
# Ubuntu/Debian
sudo apt install texlive-full
# macOS (Homebrew)
brew install --cask mactex
# Windows 用户直接下载 MiKTeX 安装包
### 3.2 获取项目源码
bash
git clone https://github.com/HEJustinSun/my-girlfriend-jingtian-latex.git
cd my-girlfriend-jingtian-latex
### 3.3 编译生成 PDF
项目里通常包含主文件 `main.tex`，直接编译即可：
bash
pdflatex main.tex
# 或者用 latexmk 自动处理多轮编译
latexmk -pdf main.tex
如果一切顺利，你会在目录下看到一个 `main.pdf`，那就是你的情书成品。
### 3.4 自定义内容
打开 `main.tex`，你会看到类似这样的结构：
latex
\documentclass[12pt]{article}
\usepackage[UTF8]{ctex} % 支持中文
\usepackage{geometry}
\geometry{a4paper, margin=2.5cm}
\begin{document}
\title{致亲爱的静恬}
\author{你的名字}
\date{\today}
\maketitle
\section{初见}
... 在这里写下你们初次见面的场景 ...
\section{心动瞬间}
... 描述那些让你心动的细节 ...
\section{为什么是你}
... 用逻辑证明“你是我的最优解” ...
\section{未来计划}
... 写下你们共同的未来 ...
\section{结语}
... 一句最真诚的话 ...
\end{document}
你可以自由修改章节、添加图片（比如你们的合照）、甚至插入数学公式来表达“你是我的唯一解”：
latex
\begin{equation}
\text{我的幸福} = \int_{0}^{\infty} (\text{你} \times \text{陪伴}) \, dt
\end{equation}
---
## 四、核心亮点：为什么它值得 3775 个 Star？
### 4.1 极简但完整的情感表达框架
项目虽然简单，但它的章节设计非常符合“情感叙事”的逻辑：初见、心动、为什么是你、未来计划、结语。这实际上是一篇结构严谨的议论文——用事实（回忆）和逻辑（情感推理）来证明“我爱你”这个命题。这种“理工科思维”恰恰是它的魅力所在。
### 4.2 中文支持极佳
项目内置了 `ctex` 宏包，对中文支持非常友好，不需要额外配置。这对于中文用户来说是一个巨大的加分项——很多 LaTeX 模板对中文支持并不完善，但这个项目直接开箱即用。
### 4.3 可扩展性强
虽然它是一份情书模板，但你可以把它改造成任何“表白类文档”——求婚信、周年纪念信、道歉信、甚至写给家人的感谢信。只要你能用 LaTeX 写，它就能帮你排版。
### 4.4 社区共鸣
这个项目最大的亮点其实是“情感共鸣”。在 GitHub 上，Star 数往往代表“我可能用得上”，但这个项目代表的是“我觉得这个想法很酷”。它让无数程序员会心一笑，甚至引发了一波“用 LaTeX 写情书”的模仿潮。
---
## 五、适用场景：谁适合用这个项目？
1. **程序员/理工科学生**：如果你正在追求一个同样懂技术或者至少欣赏技术浪漫的对象，这个项目是绝佳的选择。
2. **LaTeX 初学者**：如果你想学 LaTeX，但又觉得写论文太枯燥，用这个项目练手会很有趣。
3. **纪念日/特殊节日**：在情人节、生日、纪念日，送一份精心编译的 PDF 情书，比买花更有心意。
4. **技术社区活动**：比如在黑客松、极客聚会中，作为“程序员的浪漫”展示案例。
---
## 六、同类项目对比：它比别的“情书生成器”强在哪？
在 GitHub 上搜索“love letter”或“latex love”，能搜到一些类似项目，但大多数存在以下问题：
| 对比维度 | my-girlfriend-jingtian-latex | 其他同类项目（如 love-letter-template） |
|---------|-----------------------------|---------------------------------------|
| 中文支持 | 内置 ctex，开箱即用 | 多数为英文模板，中文需自行配置 |
| 情感叙事结构 | 有完整章节设计，逻辑清晰 | 多为单页简单样式 |
| 颜值 | 排版精美，有封面、目录、章节编号 | 样式朴素，缺乏设计感 |
| 可玩性 | 可以插入公式、图片、自定义宏 | 固定模板，扩展性差 |
| 社区热度 | 3775 Star，讨论活跃 | 通常几百 Star 以下 |
更重要的是，这个项目不是那种“一键生成情书”的在线工具，而是给了你一份可以完全掌控的源代码——你改的每一个字，都是你亲手敲进去的。这种“参与感”是其他项目无法替代的。
---
## 七、深度思考：这个项目背后的文化意义
这个项目的走红，其实反映了程序员群体的一种“自我调侃”和“浪漫重构”。在流行文化中，程序员常被刻板印象化为“不懂浪漫的直男”，但这个项目用最硬核的排版语言，写出了最柔软的文字，反而形成了一种反差萌。
它告诉我们：**浪漫不是千篇一律的玫瑰和巧克力，而是用自己最擅长的方式，去表达对另一个人的珍视**。对于一个整天和代码打交道的人来说，用 LaTeX 写情书，就像用 SQL 查询爱情，用 Git 记录感情，用 Python 模拟心动——这本身就是一种极致的浪漫。
---
## 八、总结：值得一试，但请真诚
如果你是一个对 LaTeX 感兴趣，或者想给另一半一个惊喜的开发者，这个项目绝对值得你 clone 下来玩一玩。但请注意：**模板只是骨架，文字才是灵魂**。如果你只是替换了名字，却敷衍了内容，那这份情书再精美也只是空壳。
真正的技术浪漫，不是用工具堆砌形式，而是用工具放大真诚。这个项目给了你一个很好的“排版框架”，但请务必用你自己的“情感数据”去填充它。
最后，祝所有用 LaTeX 写情书的人，都能编译成功，永不报错。
---
**项目地址**：https://github.com/HEJustinSun/my-girlfriend-jingtian-latex