MiKTeX
MiKTeX 是面向 Windows、macOS 和 Linux 的 TeX/LaTeX 发行版，提供 MiKTeX Console、TeXworks、按需安装宏包、用户级或共享安装，以及 TeX、LaTeX、LuaTeX 等排版工具链。
适合做什么
MiKTeX 适合论文、教材、公式、参考文献和复杂版式的 TeX/LaTeX 工作流。它可以从较小的基础环境开始，编译时按需安装缺失宏包，并通过 MiKTeX Console 统一处理仓库、宏包、格式、更新和用户级或共享安装。
当前版本与平台
当前核心发行标签为 26.5，于 2026-05-14 发布；Windows 官网 Basic 安装器仍名为 25.12，安装后需通过 Console 更新。macOS 官网 DMG 仍为 2022 年的 22.1 Intel 构建，Linux 则覆盖官网列出的 Ubuntu、Mint、Debian、Fedora、Rocky Linux 和 openSUSE 版本。
宏包、权限与可复现边界
MiKTeX 是由大量独立软件和宏包组成的自由软件集合，不存在覆盖全部内容的单一许可证。自动装包会联网改变环境，私有与共享安装还有不同配置层；不可信 TeX 在开放 shell escape 时可执行外部命令，正式工作流应锁定依赖、限制权限并保留完整构建记录。
维护记录
本页于 2026-08-06 根据 26.5 发行记录、Windows 25.12 Basic 安装器、macOS 22.1 DMG、Linux 软件源、Console、私有/共享安装、自动宏包和复制条件复核。
选择下载方式
下载前请核对资源版本和授权范围。本站不提供破解软件及未经授权的资料。
MiKTeX 26.5 安装、Console 更新与 LaTeX 首次编译教程
先按平台安装基础环境并选择私有或共享范围，再通过 MiKTeX Console 完成初始化、更新与宏包策略，最后用最小文档验证编译、字体、中文和 PDF 输出可复现。
安装前准备
- Windows 用户准备 x64 环境；macOS 官网磁盘镜像仍是较旧的 Intel 构建，Apple Silicon 和新系统应先验证兼容性；Linux 必须使用官网列出的发行版软件源和签名密钥。
- 决定私有安装还是由管理员维护的共享安装。除真正的多用户机器外，优先私有安装，减少管理员模式与用户模式混用。
- 备份现有 TeX 配置、个人宏包、字体、项目源码和锁定清单；若与 TeX Live 并存，记录 PATH 顺序和实际调用的可执行文件。
安装步骤
- 01
安装基础环境
Windows 运行 25.12 Basic x64 引导安装器，macOS 打开 DMG，Linux 通过签名软件源安装；首次选择私有范围并保留默认目录，除非已有统一部署规范。
- 02
完成 MiKTeX 初始化
打开 MiKTeX Console 完成 setup，刷新文件名数据库，选择纸张和宏包安装策略；macOS 与 Linux 私有安装还要确认用户 bin 目录已进入 PATH。
- 03
更新到当前组件
在 Console 检查更新并分批应用，重启后再次检查，直到核心程序与宏包没有待更新；记录最终版本，而不是只记录安装器文件名。
快速上手
- 01
编译最小文档
建立只含标题、正文和一段公式的测试源文件，使用预定引擎编译 PDF，查看日志中实际引擎、输入文件和缺失宏包。
- 02
验证自动装包策略
在测试副本引用一个尚未安装的宏包，确认系统按“询问、总是或从不”的预期处理，并记录新增宏包及版本。
- 03
测试中文与可复现性
使用项目指定的 Unicode 引擎和字体编译中文样例，清理辅助文件后离线重建一次，比较日志、字体嵌入和 PDF 页面是否一致。
使用建议
- 26.5 升级 dvipdfmx 与 LuaTeX 等组件；TeX 发行版由大量独立项目组成，更新前应备份并在关键论文上做回归编译。
- MiKTeX 可以按需联网安装宏包，便利性会降低构建可复现性；正式归档应保存源文件、宏包清单、引擎版本、字体与最终 PDF。
- 编译不可信 TeX 源码时保持 shell escape 关闭，先阅读构建脚本和自定义宏包；开放外部命令执行会让文档获得当前用户权限。
- 共享安装的系统宏包需在管理员模式维护，用户级宏包则在普通模式维护；两套状态混用是更新失败和版本冲突的常见原因。
故障排查与卸载方法
安装后找不到 lualatex 或 pdflatex 怎么办？
检查 MiKTeX Console 是否完成 setup，再确认用户 bin 或系统安装目录在 PATH 中；用终端查看实际命中的可执行文件，排除被 TeX Live 或旧 MiKTeX 覆盖。
更新或自动安装宏包反复失败怎么办？
区分私有与共享安装模式，刷新仓库和文件名数据库，检查代理、镜像、磁盘权限与日期；保留日志，不要同时以普通和管理员模式并发更新。
- 归档项目与环境信息保存 TeX 源码、个人宏包、配置、字体、宏包清单、引擎版本和最终 PDF，抽查在隔离环境能够重新编译。
- 清理对应安装范围先用 MiKTeX setup 清理私有数据；共享安装还需管理员模式清理系统数据，再移除应用或软件源。不要顺带删除仍由 TeX Live 使用的字体和项目目录。
常见问题
MiKTeX 26.5 为什么 Windows 安装器文件名还是 25.12？
26.5 是 2026-05 发布的当前核心发行标签，而官网 Windows Basic 安装器仍以 25.12 命名。引导安装完成后应立即在 MiKTeX Console 检查更新，把核心程序和宏包升级到一致状态；不能只凭安装器文件名判断最终环境版本。
MiKTeX 应选择私有安装还是共享安装？
官方明确推荐大多数用户选择私有、仅当前用户使用的安装。共享安装适合受管理员维护的多用户计算机，但用户模式和管理员模式的配置、宏包和更新必须分别处理，维护更容易出错。
是否应该开启缺失宏包自动安装？
个人联网环境可以选择询问后安装，既保持系统精简又能审查新增依赖。论文归档、教学机房、离线构建和 CI 更适合预先固定宏包集合与仓库快照，避免同一源码因日期不同产生不同输出。
下载时需要提取码吗？
夸克网盘无需提取码；百度网盘所需的四位提取码会直接显示在下载入口旁。