官网的技术文档该如何上手？-CSDN博客

本文链接：https://blog.csdn.net/JiuQianWan/article/details/126118221

本文内容：

1、为什么我们不喜欢在官网查资料？

2、为什么要优先从官网查资料？

3、如何上手？

作为一名程序员，学会从官方文档查资料，就像学会查字典一样，是一项必备且终身受益的技能。

|| 为什么我们不喜欢在官网查资料？

| 英语水平差，看不懂

我们工作中用到的技术，从编程语言到各种框架，绝大多数都起源于欧美，英语又是全球通用语言，再加上IT圈的开源、无国界理念，所以官方的技术文档也都以英语为主。就拿dubbo来说吧，现在默认的语言也是英语。

我们苦苦学了十几年的英语，到头来却发现连一份使用说明书都看不懂。很多人觉得是自己英语水平差，所以看不懂。其实不是这样的，不管你英语几级，我们在学校学的基本都是为了应付考试，主要掌握的也都是日常生活中的高频词汇。IT属于专业领域，有很多领域内的专业词汇，我们看不懂太正常了。

| 费时费力

每当我们遇到需要查资料解决的问题时，一般都是比较紧急的，可能在百度上10分钟就能找到答案的问题，从官网一个小时也不一定能找到答案，所以自然而然的就会放弃这个费时费力的途径。

| 一入行就养成了一个坏习惯

不管是在学校还是在工作中，身边大多数人都是从百度查问题。熟悉的搜索习惯，熟悉的母语，还有和自己遇到的一模一样的问题。再加上前面提到的两点困难，我们很容易就习惯了有问题先百度，找不到答案再考虑其他途径。

|| 为什么要优先从官网查资料？

| 权威、及时

自家的技术，配上自家编写说明书，再权威不过了。

就跟我们获取新闻一样，我们都知道从权威媒体、官方信息披露平台获取到的信息才真实可靠，那些非主流媒体、山寨公号微博经常散布虚假错误信息。

平时搜索出来的一些资料，可能经过几手的翻译，再加上每个人自己的理解，很有可能就给你传递出了错误的信息。

最新版本的改动，也会第一时间公布在官网的。如果你是一个尝新客，肯定要在官网获取第一手的资料，当然也包含一手的bug修复信息。

| 少走弯路

相信大家在搭建环境，或者安装某个软件的时候，都遇到过各种奇葩的问题。百度出来一堆答案，现象都一样，但原因各不同，往往尝试很多方案也没能解决。因为很多网友在共享经验的时候没有说明自己的环境信息、版本信息，所以对他有效的方法，不一定能解决你的问题。有时候我们会偶尔发现，原来在官网披露的信息中，或者官网的问题集锦中有我之前遇到的某个问题的解决方法。

尤其是新上手一门技术，官网都有快速上手的小例子，而且一般都是最新的版本。按照官方的指引入手，几乎都能成功。而百度出来的不一定是几年前的版本了。

下面通过几道面试题，说说官网文档的重要性：

面试题一：说说IoC和DI的区别。

说实话到现在我也没记住所谓的标准答案，有的说IoC是目的，DI是手段....具体能百度出多少种说法，大家自己可以百度一下看看。

我想说的是，在Spring官方文档讲IoC的这一节中，开篇就回答了这个问题。