可复用的中文 LaTeX 论文写作工作区。每次以本文件夹为基础新建 VS Code 会话即可开始一篇全新论文。
- 在 VS Code 中打开此文件夹。
- 编辑
main.tex,将TODO占位内容替换为你的论文内容。 - 运行构建任务
Build LaTeX PDF(Ctrl+Shift+B),或双击build.bat。 - 编译成功后自动打开
main.pdf预览。
你可以直接告诉 Copilot 你的论文主题和要求,让 AI 帮你生成 main.tex:
"帮我写一篇关于 XXX 的中文论文,要求包含摘要、引言、方法论、结果分析、结论和参考文献"
Copilot 会按以下工作流处理:
- 确定论文标题、摘要、章节结构、参考文献格式、是否需要图片或公式
- 生成完整的
main.tex内容(包含中文环境、数学公式、图表等元素) - 若主题明确就直接围绕主题写正文;若主题不明确则先给出默认论文框架
本模板内置 6 个 AI 协作 Skill,覆盖论文写作全流程(详见下方 AI 协作 Skill 套件)。
技术约束(已内建在模板中):
- 中文排版使用
ctex宏包,适合课程论文 / 学术论文版式 - 使用
xelatex编译两遍(不使用latexmk),确保交叉引用和目录稳定 - 图片占位使用
\IfFileExists处理缺失图片,避免编译失败 - 编译脚本
build.bat执行两遍xelatex,成功后自动打开 PDF,失败时提示错误 - 输出为可直接保存的完整文件,不添加无关的项目结构或说明
| 方式 | 操作 |
|---|---|
| VS Code 任务 | Ctrl+Shift+B → 选择 Build LaTeX PDF |
| 命令行 | 双击根目录的 build.bat |
| 清理辅助文件 | Ctrl+Shift+P → Tasks: Run Task → Clean LaTeX Aux Files |
编译引擎为 XeLaTeX(基于 MiKTeX 或 TeX Live),自动执行两次编译以生成目录和交叉引用。
前置要求:使用前请确保已安装 MiKTeX 或 TeX Live,且
xelatex已加入系统 PATH。可在命令行运行where xelatex验证。若未找到,build.bat会自动提示并退出。
论文/
├── main.tex ← 论文主文件(从这里开始写)
├── build.bat ← 一键编译脚本
├── restore.ps1 ← 恢复干净模板脚本(备选方案)
├── .gitignore ← 排除编译产物
├── README.md ← 本文件
├── .git/ ← Git 仓库(隐藏)
├── _template/ ← 干净模板备份(请勿修改)
│ └── main.tex
├── .github/
│ └── copilot/
│ └── skills/ ← AI 协作 Skill 套件(6 个)
│ ├── paper-planner/ ← 大纲规划
│ ├── lit-review-helper/ ← 文献综述
│ ├── section-writer/ ← 逐节写作
│ ├── bib-curator/ ← 参考文献管理
│ ├── latex-review/ ← 论文审查
│ └── pre-submit-guard/ ← 投稿前检查
├── images/ ← 图片目录
│ └── example-image.tex ← TikZ 绘图示例(可选参考)
└── .vscode/
├── settings.json ← LaTeX Workshop 配置
└── tasks.json ─ VS Code 构建任务
本模板已初始化 Git 仓库并提交了干净模板的初始快照。
| 场景 | 命令 |
|---|---|
| 开始新论文 | git checkout . — 丢弃所有修改,回到初始模板 |
| 保存当前进度 | git add -A && git commit -m "写了某节" |
| 查看修改记录 | git log --oneline |
| 查看改了什么 | git diff |
写完一篇论文后,想写下一篇时:
git checkout . # 丢弃所有修改,回到初始模板
git clean -fd # 删除 untracked 文件(如旧图片)注意:
git checkout .会同时回退.vscode/settings.json和.vscode/tasks.json中的编译配置。如果你修改了这些文件(例如调整了 LaTeX Workshop 设置),恢复后需要重新配置。
或对 Copilot 说 "恢复干净模板",我会帮你执行。
.\restore.ps1从 _template/main.tex 恢复空白模板并清理编译产物。
main.tex 预置了以下开箱即用的配置:
- 中文支持:
ctex宏包,章节编号为一、二、...格式 - 数学环境:
amsmath/amssymb/amsthm - 定理环境:定义(definition)、定理(theorem),可按需添加引理、命题等
- 插图:
graphicx,图片放入images/后用\includegraphics引用 - 页眉页脚:
fancyhdr,页眉显示论文标题,页脚显示页码 - 超链接:
hyperref,目录和引用可点击跳转 - 页面布局:A4 纸,2.5cm 页边距,1.5 倍行距
- 运行
git checkout .或.\restore.ps1清理上次残留 - 编辑
main.tex(或让 Copilot 帮你生成内容),修改标题、摘要、关键词、章节内容、参考文献 - 将论文用到的图片放入
images/目录 - 编译并检查 PDF 输出
- 反复修改、编译,直至完成
将 PNG、JPG、PDF 图片放入 images/ 目录后引用:
% 单张图片
\begin{figure}[htbp]
\centering
\includegraphics[width=0.7\linewidth]{images/your-image.png}
\caption{图片标题}
\label{fig:your-label}
\end{figure}
% 并排两张图片
\begin{figure}[htbp]
\centering
\begin{minipage}{0.48\linewidth}
\centering
\includegraphics[width=\linewidth]{images/fig-a.pdf}
\caption{子图 A}
\end{minipage}
\hfill
\begin{minipage}{0.48\linewidth}
\centering
\includegraphics[width=\linewidth]{images/fig-b.pdf}
\caption{子图 B}
\end{minipage}
\end{figure}images/ 目录提供了 4 个可直接编译的 TikZ 示例:
| 文件 | 类型 | 适用场景 |
|---|---|---|
example-function-plot.tex |
函数曲线图 | 展示数学函数、衰减曲线、信号波形 |
example-bar-chart.tex |
对比柱状图 | 实验对比、算法性能比较 |
example-flowchart.tex |
方法流程图 | 算法流程、系统架构、实验步骤 |
example-neural-net.tex |
网络结构图 | 神经网络、模型架构示意 |
编译 TikZ 图为 PDF:
cd images
xelatex example-function-plot.tex # 生成 example-function-plot.pdf
xelatex example-bar-chart.tex
xelatex example-flowchart.tex
xelatex example-neural-net.tex编译后在 main.tex 中引用:
\includegraphics[width=0.7\linewidth]{images/example-function-plot.pdf}修改 TikZ 图: 编辑 .tex 文件中的颜色、数据、标签等,重新编译即可更新 PDF。
直接嵌入正文(无需单独编译): 在 main.tex 导言区添加 \usepackage{tikz},然后将 \begin{tikzpicture}...\end{tikzpicture} 代码直接放入 figure 环境中。
| 格式 | 适用场景 | 特点 |
|---|---|---|
| TikZ 导出、矢量图表 | 矢量无损,推荐首选 | |
| PNG | 截图、渲染结果 | 无损压缩,适合位图 |
| JPG | 照片、自然图像 | 有损压缩,文件小 |
| SVG | 需先转 PDF | LaTeX 不直接支持 |
提示:论文插图优先使用矢量格式(PDF/TikZ),避免放大后模糊。位图分辨率建议 ≥ 300 dpi。
- 添加宏包:在
main.tex导言区添加\usepackage{...} - 修改页边距:调整
\geometry{...}参数 - 修改行距:调整
\setstretch{...}值 - 添加定理环境:取消注释
main.tex中对应的\newtheorem行
- 文件名和路径中避免使用中文和空格,防止编译问题
- 首次编译若缺少宏包,MiKTeX 会提示自动安装
- PDF 查看器已设为外部打开,避免 VS Code 内置 PDF 视图锁定文件
本模板内置 6 个 VS Code Copilot Skill(.github/copilot/skills/),覆盖论文写作全流程。在 Copilot Chat 中输入触发词即可调用,无需额外安装。
graph LR
A["📐 paper-planner<br/>大纲规划"] --> B["📚 lit-review-helper<br/>文献综述"]
B --> C["✍️ section-writer<br/>逐节写作"]
C --> D["🔍 latex-review<br/>审查排版"]
D --> E["🛡️ pre-submit-guard<br/>投稿前检查"]
F["📎 bib-curator<br/>文献管理"] -.-> B
F -.-> C
F -.-> E
| 项目 | 说明 |
|---|---|
| 触发词 | 规划论文、论文大纲、章节结构、论证结构、研究框架、帮我规划 |
| 功能 | 根据主题生成多级章节大纲、检查论证链完整性(循环论证/跳跃推理/缺失章节)、输出可填入 main.tex 的 \section{} 骨架 |
| 示例 | "帮我规划一篇关于深度学习图像分割的论文结构" |
| 项目 | 说明 |
|---|---|
| 触发词 | 文献综述、找文献、literature review、文献检索、综述框架、相关研究 |
| 功能 | 多源检索策略指导(arXiv/CNKI/Semantic Scholar)、文献按方法/时间线聚类、生成综述骨架、检查是否有遗漏方向 |
| 示例 | "帮我找 Transformer 在时间序列预测方向的文献,梳理成综述" |
| 项目 | 说明 |
|---|---|
| 触发词 | 写这一节、展开段落、润色这段、写摘要、改写这段、学术润色 |
| 功能 | 要点→段落展开、段落润色(口语→学术)、中英文摘要编写/翻译、章节过渡句生成 |
| 示例 | "帮我把引言这段润色得更学术一些" |
| 项目 | 说明 |
|---|---|
| 触发词 | 参考文献、引用格式、bib、文献条目、GB/T 7714、补全文献、检查引用 |
| 功能 | DOI/arXiv ID → GB/T 7714 条目、交叉比对幽灵引用与孤立条目、格式校验(标点/字段完整性)、生成 .bib 文件 |
| 示例 | "帮我把 10.1038/nature12373 转成 GB/T 7714 参考文献格式" |
| 项目 | 说明 |
|---|---|
| 触发词 | 检查论文、审查论文、论文查错、LaTeX 审查、review paper |
| 功能 | 学术性错误排查(逻辑漏洞/循环论证)、排版格式检查(编译错误/标点/图片路径)、改进建议、审查后修改并交付 PDF |
| 示例 | "帮我全面检查一下这篇论文" |
| 项目 | 说明 |
|---|---|
| 触发词 | 投稿检查、提交前检查、格式检查、submission check、最终检查、合规检查 |
| 功能 | 编译验证(Error/Warning 解析)、格式合规(页数/行距/标题编号)、引用完整性、图表路径检查,只检查不修改 |
| 示例 | "投稿前帮我跑一次完整检查" |
1. 说"帮我规划一篇关于 XXX 的论文" → paper-planner 生成章节骨架
2. 说"帮我找这个方向的文献" → lit-review-helper 检索 + 聚类
3. 说"帮我把引言这一节展开写" → section-writer 逐节成稿
4. 说"帮我生成参考文献" → bib-curator 格式化引用
5. 说"帮我全面检查论文" → latex-review 审查 + 修改
6. 说"投稿前帮我跑一次检查" → pre-submit-guard 最终把关