开发工具笔记最容易变成链接堆。真正有价值的整理方式，不是把所有工具都塞进一页，而是按使用场景分层：知识库、格式化、HTTP 调试、数据库客户端、本地静态服务和文件上传排障分别维护。
先给工具笔记定边界
一页“开发工具”适合放共性入口，但不要承载所有细节。可以按下面的规则拆分：
- 编辑器、格式化、数据库客户端、本地前端工具和 VSCode 插件放在工具页。
- HTTP 请求、curl、Postman、Apifox 这类调试内容单独成页。
- Mac、Homebrew、zsh completion 和系统问题单独成页。
- 上传接口中的真实地址、密码、本机路径和内网域名不要进入公开正文。
这样做的好处是后续检索更稳，也能避免公开文章夹带内网信息。
Obsidian 同步方案怎么选
Obsidian 的同步方案可以按“可靠性”和“维护成本”排序：
- 官方同步：省心，但需要付费。
- iCloud / OneDrive：适合轻量同步，但偶尔会有延迟。
- Git + Shortcuts：适合能接受版本管理的人，移动端自动化需要额外维护。
- Remotely Save：可以对接云盘，但需要留意插件兼容性。
如果笔记是长期主库，建议优先保证“不会丢”和“能回滚”，不要只看同步速度。
Prettier 配置要统一
前端、文档和 Markdown 混在一起时，格式化规则必须统一，否则每次协作都会制造无意义 diff。常见配置项包括：
{
"printWidth": 120,
"tabWidth": 2,
"useTabs": false,
"semi": true,
"singleQuote": true,
"trailingComma": "es5",
"bracketSpacing": true,
"arrowParens": "always",
"proseWrap": "preserve"
}几个字段最容易影响团队体验：
printWidth：控制换行密度。tabWidth和useTabs：决定缩进风格。singleQuote和semi：影响代码视觉一致性。proseWrap：对 Markdown 很重要，避免中文段落被频繁重排。
本地静态服务可以用 http-server
本地打开 HTML 文件时，经常会遇到跨域、路径和资源加载问题。简单场景可以用 http-server：
pnpm install -g http-server
http-server -p 3000进入目标目录后启动，就能用本地 HTTP 地址访问页面。它适合临时预览静态页面、复现资源路径问题和做轻量前端联调。
数据库客户端只记录使用入口
DataGrip、Navicat、DBeaver 这类工具更适合记录“导入导出、连接类型、常见坑”，不要在公开笔记中保存真实连接串、账号、密码或内网主机。
数据库客户端笔记可以保留：
- SQLite、MySQL、PostgreSQL 的连接方式。
- CSV / SQL 导入导出路径。
- 编码、时区、换行符问题。
- 只读连接和生产连接的区分原则。
curl 上传示例要脱敏
上传文件接口的 curl 示例很容易泄露真实地址、密码和本机路径。公开笔记里可以保留结构，但要使用占位符：
curl --location 'https://example.com/file/upload' \
--form file=@"./demo.zip" \
--form 'file_param="{\"file_type\":\"zip\",\"category\":\"other\"}";type=application/json'重点是记录 multipart 表单结构、字段名和调试方法，而不是记录真实接口。
实用结论
开发工具整理的核心不是“工具越多越好”，而是按场景形成稳定入口：知识库负责长期沉淀，格式化工具负责一致性，本地 HTTP 服务负责快速预览，数据库客户端负责数据排查，curl 示例负责接口复现。能公开的写成通用模式，不能公开的放到私密配置或项目文档里。
正文完
