前几天在群里聊天，有个刚入行没多久的朋友问我，说现在网上教程满天飞，但真正能跑起来的代码和顺手趁手的工具反而越来越难找。他这么一说，我倒想起来自己硬盘里那个叫「小马哥永久免费资料」的文件夹了。这东西跟了我快五年，从最早只有几个G的零散文档，到现在分门别类塞满了各种开发工具、环境配置包和实战教程，中间删删改改不知道多少回。今天索性把里面还在用的东西翻出来捋一捋，给还在到处翻教程的朋友省点力气。

先说清楚，这堆资料没什么神秘来源，都是这些年从各种技术社区、开源项目文档、还有同行随手分享里一点点攒下来的。小马哥这个名号也不是什么大神，就是最早整理这些包的那个老哥的网名，后来大家叫顺口了，也就不断这么传下来。里面东西杂，但有一条原则：所有工具和教程，必须是我自己或者身边人实际跑顺利获得、踩过坑的，光看着漂亮但跑不起来的，早被我清出去了。

开发环境搭建：从裸机到顺手的头一个小时

不管你是写Java、Python还是搞前端，装环境永远是第一道坎。小马哥资料里有个「环境三件套」的文件夹，里面放的是JDK、Node.js和Python的离线安装包，版本都选的是LTS长期支持版。为什么强调离线？因为国内某些网络环境下，去官网下个JDK能卡你半小时，尤其Oracle那会儿还改过下载策略，现在虽然好点了，但备一份离线包总没错。JDK我留的是8、11、17三个版本，8是给老项目维护用的，11和17是现在新项目的主流。Node.js留的是16和18，Python是3.8和3.10。每个安装包旁边都配了一个txt，写清楚安装路径怎么选、环境变量怎么配、验证命令是什么。别看这些东西简单，新手卡在“java不是内部或外部命令”这种问题上能折腾一下午。

除了语言运行时，还有个「编辑器与IDE」的子文件夹。VS Code、IntelliJ IDEA社区版、PyCharm社区版、还有Notepad++和Sublime Text。VS Code的插件列表单独存了一个json文件，里面是我自己常用的二十来个插件，像Prettier、ESLint、GitLens、Python、Remote-SSH这些，直接导入就能用。IDEA那边则是把常用的快捷键映射和几个必装插件（比如Lombok、Maven Helper）的说明写成了文档。有次帮一个学弟配环境，他照着文档一步步走，四十分钟就把Java Web的一整套跑通了，搁以前自己摸索起码得半天。

版本管理：Git和SVN的那点事

Git现在是标配了，但很多人只会clone和push。小马哥资料里有个「Git实战场景」的文档，里面列了十几个真实场景：怎么撤销已经push的提交、怎么合并两个不相关的仓库、怎么用rebase整理提交记录、怎么找回被reset删掉的分支。每个场景都配了命令和操作前后的仓库状态图，用的是那种手绘风格的示意图，比看官方文档直观多了。SVN虽然用得少了，但有些老公司还在用，所以也留了一份TortoiseSVN的安装包和常见冲突解决步骤。这部分内容不算多，但关键时刻能救命。

常用工具链：那些让你少写重复代码的东西

工具这块我分了几类。第一类是「构建与包管理」，Maven、Gradle、npm、yarn、pip的配置文件和镜像源设置都在里面。特别是Maven的settings.xml，里面配好了阿里云的镜像，还有本地仓库路径的修改说明。Gradle则是把常用的依赖配置写成了模板，新建项目直接复制粘贴。npm和yarn的镜像源切换命令也整理成了一个小脚本，双击就能跑。

第二类是「数据库与中间件」。MySQL、PostgreSQL、Redis、MongoDB的安装包和基础配置都有，每个都附带了Docker版本的docker-compose.yml文件。现在用Docker跑这些服务方便太多了，一个命令拉起来，不用在宿主机上装一堆东西。Redis的配置文件里还标注了几个常用参数，比如maxmemory和maxmemory-policy怎么设，bind和protected-mode怎么调。这些细节网上教程经常一笔带过，但实际用的时候不注意就会踩坑。

第三类是「接口测试与调试」。Postman的安装包和几个常用的collection模板，还有curl命令的速查表。Postman现在强制登录有点烦，所以还备了一个Insomnia的安装包作为替代。抓包工具留了Fiddler和Wireshark，Fiddler的证书配置步骤写得很细，因为这一步卡住过很多人。Wireshark则是配了几个常用的过滤表达式，比如只看HTTP请求或者只看某个IP的流量。

效率工具：藏在文件夹角落的小玩意

有几个小工具虽然不起眼但使用频率极高。一个是「JSON格式化与校验」的离线工具，不用联网就能用，支持格式化、压缩、转义和校验。另一个是「文本diff对比」的工具，比Beyond Compare轻量，启动快。还有个「正则表达式测试器」，里面预置了几十个常用正则，比如邮箱、手机号、URL、日期格式，直接拿来改改就能用。这些工具都是绿色版，解压就能跑，不写注册表，放在U盘里随身带也方便。

教程与文档：从入门到能干活的那条路

教程这部分我筛得比较狠。网上那种“三天学会XXX”的基本都删了，留下来的要么是官方文档的离线版，要么是经过时间检验的系列文章。Java方向留的是《Java核心技术》的笔记和一份Spring Boot实战教程，后者是一个前辈写的，从零搭一个博客系统，每一步都有代码和解释，不是那种只贴代码不解释为什么的。Python方向留的是《流畅的Python》读书笔记和一份爬虫实战教程，爬虫教程里特别强调了robots.txt和请求频率控制，这点我觉得比教你怎么破解反爬更有价值。

前端方向东西最多，HTML/CSS/JavaScript的基础教程用的是MDN的离线镜像，然后加了一份React和Vue的对比入门。React那部分重点讲了Hooks和状态管理，Vue那部分则是从Options API讲到Composition API。每个教程都配了可运行的示例代码，放在对应的文件夹里，用浏览器直接打开就能看效果。有个「前端项目实战」的子文件夹，里面是三个完整的项目：一个待办事项应用、一个天气查询页面、一个简单的电商后台。代码不算复杂，但涵盖了路由、状态管理、API调用、表单处理这些核心概念。

算法与面试：刷题之外的基本功

算法资料没有放那种几千道题的题库，而是选了一份「算法图解」的笔记和LeetCode前两百题的分类整理。分类整理是按标签来的，比如数组、链表、二叉树、动态规划，每个标签下面挑十道左右的经典题，附上解题思路和代码。代码用的是Java和Python两种语言，方便对照。除了算法，还有一份「计算机基础」的文档，涵盖了操作系统、计算机网络、数据库原理的常见面试题和简答。这些内容平时写业务代码可能用不上，但面试的时候问起来，答不上来就很尴尬。

资料怎么用才不白瞎

东西多归多，但一股脑全塞给你反而容易让人焦虑。我的建议是按需取用。如果你刚开始学编程，先把环境搭好，然后挑一门语言的基础教程过一遍，跟着写代码，别光看。遇到问题了再去工具文件夹里找对应的工具，比如数据库连不上就去翻MySQL的配置说明。如果你已经工作了，想补某一块的知识，就直接跳到对应的教程文件夹，比如想学React就只看React那部分，别从头开始。资料是死的，人是活的，用得上才是好资料。

还有一点，这些工具和教程的版本会过时。比如JDK现在最新LTS是21了，Node.js也到20了，我留的版本可能不是最新的，但都是稳定且经过验证的。如果你要用新版本，注意看一下官方有没有破坏性变更。教程里的代码也一样，框架版本更新后API可能会变，遇到报错先去官方文档查一下，别死磕教程里的写法。小马哥这个文件夹之所以叫“永久免费”，不是说内容永远不更新，而是说这些东西你拿去用、拿去改、拿去传给别人，都没人管你。技术这东西，本来就是越分享越值钱。

最后提一嘴，文件夹里有个「README.txt」，里面写了每类资料的更新日期和简单的使用说明。虽然文件不大，但第一次打开的时候最好扫一眼，能省不少翻找的时间。好了，就啰嗦这么多，希望能帮到还在到处找资料的朋友。