刚接触一个新框架，打开官网第一眼看到的就是“文档”两个字。点进去却发现内容密密麻麻，API 一堆参数，示例代码看不懂，心里直打鼓：这玩意儿到底该怎么看？
别急着写代码，先找入口
很多人一上来就想直接抄例子跑通项目，结果改两行就报错。其实大多数框架的文档结构都差不多，关键是要找到“Getting Started”或者“快速开始”这类章节。比如 Vue 的文档首页就有个“安装”和“创建一个应用”的引导，跟着一步步来，比直接啃 API 强多了。
帮助文档不是字典，别从头读到尾
我见过不少人真的一章一章往下读文档，跟看书似的。其实更高效的方式是“查字典”——你遇到问题了，再去搜对应的功能模块。比如你在用 React 时不知道怎么处理表单输入，直接去文档里搜“form”或“input”，很快就能定位到相关说明。
善用搜索功能和侧边栏目录
现代框架文档基本都有右侧或顶部的搜索框。像 Vite、Tailwind 这类项目的文档站，搜“部署”、“环境变量”几乎秒出结果。如果搜不到，看看左侧目录有没有“指南”、“配置”、“常见问题”这些分类，通常你要的答案就藏在里面。
看懂代码示例才是关键
很多新手看文档只读文字描述，跳过代码块。其实真正有用的往往是那一小段 example。比如 Axios 的文档里有个 POST 请求的例子：
axios.post('/api/user', {
name: 'john',
age: 25
})
.then(response => {
console.log(response.data);
});你看懂这一段，比读十行解释都管用。试着把它复制到自己项目里，改个接口地址，运行一下，立马有感觉。
别怕英文，常用术语就那几个
有些同学一看英文文档就犯怵。其实技术文档用词非常固定，props、state、mount、render、config……翻两次词典就记住了。实在不行可以用浏览器翻译功能，虽然句子可能不太顺，但关键词一般不会错。
动手改，比光看强十倍
前两天同事问我为什么看不懂 Element Plus 的表格组件文档。我让他把官网示例代码拷一份到本地，然后把“姓名”“年龄”列改成“商品名”“价格”，再删掉分页功能试试。他搞了半小时，突然说：“哦，原来这么简单。” 其实文档不是用来“懂”的，是用来“试”的。
下次打开一个框架的帮助文档，别慌。找准入口，带着问题去找答案，边看边敲，你会发现那些看起来高大上的东西，其实也就那么回事。