传统写文章的情境

在传统的科研写作中，我们习惯像烹饪一样“凭感觉”：在 Word 里调整格式，在文件夹里手动保存 Final_v2_really_final.doc。但在 AI 时代，这种方式已经过时了。

结合 VS Code + AI (Gemini/Copilot) + LaTeX + Git，我们可以像开发软件一样写论文：文档即源码，AI 是结对编程伙伴，Git 是时光机。

本文尝试打造的写文章新工作流

本文将手把手带你搭建这套“超级工作台”

image-20260101170315183

核心工具栈

• 工厂 (IDE): Visual Studio Code (VS Code) —— 所有工作的中心枢纽。

• 引擎 (Language): LaTeX —— 保证排版与内容的专业分离。

• 大脑 (AI Agent): Gemini / Copilot / Cline —— 负责草稿生成、润色与代码修复。

• 时光机 (VCS): Git —— 记录每一次思维的迭代。

第一步：环境配置 (The Setup)

安装核心插件

打开 VS Code，安装以下必备插件：

• LaTeX Workshop: LaTeX 写作的神器，提供编译、预览、辅助等全套功能，它会自动同步overleaf的项目

• AI 助手 (如 Google Gemini 或 GitHub Copilot): 你的写作副驾驶。

• GitLens: 增强 Git 功能，能看到每一行文字是谁在什么时候写的，以及为什么写。

开启“保存时自动格式化”

分支管理

为了让 Git 的版本对比（Diff）清晰可读，必须保证代码格式的统一。不要手动调整缩进，交给机器去做。

在 VS Code 的 settings.json 中添加配置，使用 latexindent 自动格式化：

1
2
3
4
"[latex]": {
    "editor.formatOnSave": true,
    "editor.defaultFormatter": "James-Yu.latex-workshop"
}

这样，每次保存时，混乱的代码瞬间变得整齐划一，Git 提交记录里只会有内容的变更，而不会有格式的干扰。

  1. 配置 .gitignore (保持仓库洁癖)

LaTeX 编译会产生大量临时文件 (.aux, .log, .fls)。千万不要把它们上传到 Git！ 在项目根目录新建 .gitignore 文件：

1
2
3
4
5
6
7
8
*.aux
*.log
*.out
*.pdf
*.toc
*.synctex.gz
*.fls
*.fdb_latexmk

第二步：工作流实战 (The Workflow)

这是这套系统的核心循环：

  1. 建立“上下文索引” (Context Setup)

不要直接让 AI “写一个摘要”。AI 需要上下文。建议在项目里建一个 context 文件夹，放入：

  • constitution.md: 借用spec-kit项目的观点，你需要写个“宪法”规则，让AI在每次的执行中都必须参考这个规则（比如写作规范等）
  • references: 你的参考文献库（可以是个文件夹, 包含多个参数文章），可以是tex/txt/word等直接可读格式，避免使用pdf（因为会消耗更多token）
  • summary.md: 你的核心论点、实验数据摘要或大纲，这可以扩展成个文件夹
  1. 结对写作 (Pair Writing)

在 VS Code 的侧边栏或 Chat 窗口中，根据需求写 Prompt：

“基于 summary.md 中的实验结果，帮我撰写 Results 章节，使用 LaTeX 格式，引用 references 中的 [Author2024]”，AI 生成代码后，若使用了agent模式，它会直接插入到 .tex 文件中。

  1. 即时编译与预览
  • LaTeX Workshop 会自动触发编译，右侧预览窗口实时更新 PDF。
  1. 提交 (Git Commit)

写完一个段落或修复一个 Bug 后，立即提交git

如果是agent模式，则直接向ai说：提交git

或者手动提交：

1
2
git add .
git commit -m "feat: 完成 Discussion 章节初稿"

如果想尝试不同的论述逻辑，可以创建一个新分支 (git branch experiment-v1)，不满意随时切回主分支，毫无心理负担。

总结

这不仅仅是换个工具写论文，这是一场思维范式的转变。

  • PDF 只是最终编译出的可执行文件 (Build Artifact)。
  • AI 是你的员工 (Agent)。
  • VS Code 是工厂 (Factory)。
  • 你的论文是源码 (Source Code)。

这种“软件工程化”的写作方式，能让你从繁琐的排版和版本混乱中解脱出来，专注于最核心的——思想本身。