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中与当前阶段一致的一条路线。
• 笔记里保留可复查的页面名称和判断，下载或部署前会回到当前官方页面复核。