Meta Llama 开发者文档入门教程

第一次打开 Meta Llama 开发者文档，最容易犯的错不是看不懂英文，而是直接点“Download”。型号、提示格式和运行资源还没确认，下载动作就先开始了，后面常常要重新选模型。更稳妥的顺序是：先认清官方文档入口，再读模型卡和提示格式，随后决定获取方式，最后才进入实践或集成指南。

这套路径适合第一次查阅 Llama 官方资料的开发者。它解决的是“去哪里找、先看什么、如何判断找对了”三个问题，不代替某个模型的许可证、硬件需求、部署参数或框架版本说明。浏览器页面上的型号、合作方和功能入口会更新，真正下载或部署前仍要回到对应的当前页面复核。

开始前先定好要查的任务

准备一台能正常打开 Meta 开发者站点的电脑和现代浏览器。先用一句话写下目标，例如“确认一个适合本地实验的模型并找到提示格式”，不要只写“学习 Llama”。目标越具体，越容易在左侧导航里判断该进 Models、Download、How-to guides 还是 Integration guides。

还要分清三类结果：模型卡回答模型是什么，提示格式回答输入怎样组织，获取页面回答从哪里取得模型。三者不能互相替代。看到第三方文章与官方页面不一致时，以当前官方页面为准，并把未核实的版本、资源量和合作方状态留到对应页面确认。

第一步：确认进入 Llama 文档首页

入口位置：在 Meta 开发者站点进入 AI 文档，再打开 Llama Documentation 的 Get started 区域，选择 Overview。

主要动作：只核对页面身份，不急着点击下载。页面中部应显示“Get started with Llama”，左侧应能看到 Models、Use our models 和 Building with Llama 等导航分组。

成功标志：面包屑停在 Llama Documentation、Get started、Overview，左侧同时出现模型、获取与构建相关入口。这说明后续查到的内容属于官方 Llama 文档体系。

失败处理：如果只看到 Meta 首页、产品宣传页或没有左侧文档导航，返回开发者站点的 Documentation 入口重新选择 Llama；页面文字或卡片没有加载时，刷新一次并关闭阻止脚本的扩展，再重试。

看图时先认左侧三层结构，而不是盯着顶部活动横幅。左侧导航才是稳定的任务入口；Overview 被高亮，说明当前处在整套文档的起点。

第二步：按目标选择模型版本

入口位置：回到左侧导航的 Models 分组，展开或选择具体型号，例如 Llama 4、Llama Guard 4、Llama 3.3 或 Other models。

主要动作：根据任务只选一个型号入口。需要通用生成能力时先看主模型；需要安全分类或内容防护资料时再进入 Guard 系列，不要因为名称相近就把两类文档混在一起。

成功标志：正文标题变成所选型号，页面能看到该型号的模型说明、版本信息或对应子页面入口，左侧高亮位置也随之变化。

失败处理：如果型号名称与项目里准备使用的仓库名对不上，先退回 Models 的 Overview 核对系列与版本；无法确认时不要下载，也不要拿旧型号的提示模板套到新型号上。

第三步：先读模型卡再判断适用性

入口位置：在所选型号的条目或详情页找到 Model Card。

主要动作：只核对模型属性与边界，包括输入类型、主要用途、版本说明以及页面明确列出的限制。把与当前任务有关的结论记成一行，例如“要处理图片与文本，继续核对该型号的多模态输入要求”。

成功标志：已经能用一句话说明为什么选择这个型号，并能指出这个判断来自模型卡的哪个属性，而不是来自型号名称或宣传语。

失败处理：如果模型卡只有概括，沿当前型号页面查找更具体的说明；若任务需要的输入、语言或安全边界没有写明，把结论标为未确认，不要自行补全。

第四步：单独核对提示格式

入口位置：回到同一型号条目，打开 Prompt Format 或页面中的提示格式章节。

主要动作：对照当前型号检查角色、分隔符、换行、模板和终止标记等要求。提示格式属于模型版本的一部分，应由当前模型文档或随模型提供的 tokenizer 配置决定。

成功标志：能够指出项目应采用哪一版模板，以及是由代码显式拼接还是交给 tokenizer 的聊天模板处理；示例输入与文档结构一致。

失败处理：如果示例来自另一个型号或旧版本，停止复制；回到 Models 重新进入当前型号。换行和特殊标记看不清时，优先查看官方示例文件，不要靠手工猜测。

第五步：选择模型获取路径

入口位置：在 Overview 向下找到 Get the models，或从左侧 Use our models 分组进入 Download、Cloud partners、Edge partners。

主要动作：只选择一种获取路径。需要自己管理模型文件时查看直接下载或下载合作方；希望由现有服务承载时查看云端或边缘合作方。先做路径判断，再进入登录、许可确认或下载步骤。

成功标志：已经明确“直接取得模型文件”还是“通过服务使用模型”，并进入与该选择一致的当前页面。型号条目旁的 Model Card、Prompt Format 和 Get the model 分栏也能对应上。

失败处理：如果目标型号在合作方页面暂未出现，回到 Getting the models 查看当前支持提示；不要用另一个型号的下载按钮代替。遇到账号、许可或地区限制时，停在官方流程内处理，不从不明镜像绕过。

这张图要看的是三个并列入口：Model Card 用来判断模型，Prompt Format 用来组织输入，Get the model 才负责获取。把顺序颠倒，最容易造成型号选错或提示模板不匹配。

第六步：用官方 GitHub 资源补可执行示例

入口位置：继续向下滚动 Overview，找到 Find us on GitHub 区域。

主要动作：根据缺口选择一个资源。需要笔记本、演示和微调示例时进入 Llama cookbook；需要提示优化工具时查看 Prompt Ops。先读仓库说明和示例前提，再决定是否放进本地项目。

成功标志：找到与当前任务一致的示例目录或工具说明，并能说清它补的是“模型调用示例”还是“提示优化”，没有把两个资源当成同一种教程。

失败处理：如果示例依赖的型号、框架或硬件与项目不一致，返回官方文档换选适用示例；不要为了跑通而随意删掉安全检查或版本约束。

Llama cookbook 和 Prompt Ops 在页面上被分成两张卡片，说明它们解决的是不同问题。新手先选一张，不要同时拉入多个仓库后再猜哪个文件才是入口。

第七步：按开发阶段进入后续指南

入口位置：在 Overview 底部找到 Other topics in this guide，或使用左侧 Building with Llama 分组。

主要动作：按当前阶段选一个分支。仍在取得模型时进入 Getting Llama models；要做提示工程、微调、量化、蒸馏、验证或负责任使用时进入 How-to guides；要接入 LangChain、LlamaIndex 或相关 RAG 方案时进入 Integration guides；只有遇到官方文档未覆盖的问题时再查看 Community support。

成功标志：新页面标题与任务一致，而且能看到对应的子主题。比如 How-to guides 会列出 Prompt engineering、Fine-tuning、Quantization、Distillation 和 Validation 等方向。

失败处理：如果进入页面后只看到与目标无关的主题，退回 Overview 重新判断阶段；集成问题不要在模型获取页里找，模型许可与下载问题也不要交给社区帖子替代官方说明。

四张卡片就是后续路线图：获取、实践、集成、社区支持。每次只沿一条路线深入，读完再回到 Overview 切换任务，资料不容易串线。

第八步：把查阅结果收成一条可复查路径

入口位置：回到自己的项目笔记或任务单，不在浏览器里继续无目的地开新标签。

主要动作：记录五项结果：所选型号、模型卡判断、提示格式来源、模型获取路径、下一份实践或集成指南名称。只记页面名称和判断，不把可能变化的宣传语当成长期结论。

成功标志：关闭浏览器后，仍能按“Overview → 型号 → Model Card → Prompt Format → 获取方式 → 后续指南”复述路径；下一次复核时知道该回到哪一页。

失败处理：如果记录里只有“Llama 文档”或“下载模型”这类宽泛词，说明路径还不完整。重新补上具体型号与页面名称；任何未在官方页面看到的结论都标成待核验。

完成检查清单

• 浏览器显示 Llama Documentation 的 Overview，左侧导航分组完整。
• 已经选定一个具体型号，没有混用 Guard 系列与通用生成模型的资料。
• 模型卡和提示格式分别核对，提示模板对应当前型号。
• 已经决定直接下载、下载合作方、云端合作方或边缘合作方中的一种路径。
• 知道 Llama cookbook 与 Prompt Ops 分别解决什么问题。
• 下一步只进入 Getting models、How-to、Integration 或 Community 中与当前阶段一致的一条路线。
• 笔记里保留可复查的页面名称和判断，下载或部署前会回到当前官方页面复核。