本地开发环境的资料很杂：Excel、代理、Homebrew、Mac 软件、本地服务、IDE、脚手架、账号注册都可能混在一起。时间一长，最需要的不是更多链接，而是一张好用的索引。
为什么要做索引
本地工具类笔记有两个特点：
- 单条记录通常很短。
- 真用的时候又很急。
比如 npm 代理、Homebrew 换源、Mac 服务安装、Excel 拼 SQL、IDE 配置、前端请求排查，单独看都不复杂，但散落在不同文件里就很难找。
所以索引页的价值是把入口收拢起来。
可以按场景拆
我会把本地工具拆成几组：
- 办公和 Excel。
- 账号、网络和代理。
- Mac 系统和 Homebrew。
- 本地服务安装。
- IDE 和开发客户端。
- 前端请求和脚手架。
- 小工具和图标资料。
每组只放入口和边界，不在索引页堆大量正文。
账号和代理要单独放
账号、代理、VPN、邮箱、token 这类内容容易涉及隐私。它们最好单独成页，并写清楚存放策略：
- 公开笔记只放方法。
- 真实账号放私密目录。
- token 不写进公开仓库。
- 代理节点不放在公开页面。
- 失效信息及时标注。
这样既方便查找，也不容易误发布敏感内容。
Homebrew 和本地服务分开
Homebrew 本身是一类工具，本地服务安装又是另一类。比如安装 ELK、HBase、Kubernetes、MySQL、Redis 时，重点不只是 brew install，还包括：
- 服务启动方式。
- 配置文件位置。
- 数据目录。
- 端口。
- 卸载和清理。
- 与项目环境的关系。
这些内容适合独立维护。
IDE 和脚手架适合按问题查
IDE、WebStorm、VSCode、Navicat、Postman、脚手架和开源项目资料，可以按问题查找：
- 接口调试。
- 数据库客户端。
- 前端请求排查。
- 本地静态服务。
- 项目模板。
- 图标和素材。
这比按软件名硬分类更贴近使用场景。
维护规则
本地开发工具索引可以遵守几条规则：
- 索引页只放入口和边界。
- 真实账号、token、私有路径不要写进公开页。
- 每个专题页只解决一类问题。
- 失效工具不要直接删除，先标注状态。
- 新工具先写用途，再写命令。
好的工具索引不是收藏夹，而是一个能帮你在本地开发出问题时快速定位答案的目录。
正文完
