“写笔记”支持四种格式——Word 文档、Excel 表格、Markdown、纯文本,起稿或二次编辑时都能随时切换,同一篇笔记想用哪种形态来记,都由你说了算。
md、txt、csv、json 这类纯文本则原样载入,不做多余加工。拿一张现成的表倒进来、改几笔、再导出去,等于白用一台免费的格式转换器。
要带走就在右上角点“下载”,可导出 PDF、Word、Markdown、Excel、TXT 等格式;列表卡片“⋯”菜单里,也有同样的下载入口。
在“工具”页点“+ 上传工具”即可发布:填好名称与链接,再用 Markdown 把使用方法写清楚——能解决什么问题、怎么装、怎么用,比堆介绍实在。
要分发安装包就一并上传压缩包(ZIP、RAR、7Z、TAR.GZ,最大 35MB),别人在详情页一键下载;只放链接不带附件也可以。
工具按大家的收藏热度排序,好用的自然会被顶上来。发布后可在详情页或卡片菜单里编辑、下架。
写笔记时勾上“隐藏”,这篇就只存在于你自己的账号里:不进列表、不进搜索、不上首页精选,也不会出现在任何公开的页面,链接发给别人同样打不开。
适合放密码、草稿、日记这类只给自己看的内容;想公开,去“发布”打开它,把“隐藏”的勾去掉再保存,之后编辑会默认保持原状态,不会悄悄变回公开。
你的内容会同时保存在多个副本上,系统定期做备份与完整性校验,再配合异地容灾机制:就算某台机器出问题,数据也不会丢,可以长期放心存放;特别重要的资料,仍建议你另外再留一份备份。
全站跑在容器化、模块化的现代架构上,更新、部署、回滚都很快,扩展性和稳定性都按长期运营的标准来设计(Built for reliability, designed to scale)。
这个网站最早只是一个人的笔记仓库,后来慢慢长成现在的知识中枢。设计上很克制——没有广告、没有追踪、没有推荐算法,只是干干净净地存放一些东西;既然做好了,就公开出来,万一有人用得上呢。
不做大而全,不做平台梦,保持简单、保持克制、保持好奇。所有内容都由用户贡献、由用户维护:不会突然冒出付费墙,不会在角落塞广告位,也不会把你的数据卖给第三方。
产品会持续迭代,站内日志页记录着每一次改动,改了什么都有迹可循;想了解这个站是怎么一步步走到今天的,翻翻日志就能看到来龙去脉。
如果在这里看到涉嫌违规的内容,点对应卡片右侧的“举报”按钮就能提交,我们会尽快核实处理;也谢谢你花一点时间,一起把这里维护干净。
Postman
Postman — 一款API调试与测试工具,让HTTP请求变得可视化、可管理。
说实话,我写代码这几年,最离不开的工具之一就是Postman。如果你是个后端开发者,或者前端要调接口,甚至做自动化测试的,大概率都跟它打过交道。但很多人只用它发个GET请求,那真是暴殄天物。今天我就从实际使用的角度,好好聊聊这个工具到底怎么用,能帮你省多少时间。
这个工具是干什么的
Postman本质上是个HTTP客户端。你平时写后端接口,调试的时候是不是得写curl命令?或者前端开发,后端接口还没写好,你得自己模拟数据?Postman就是来解决这些麻烦的。
它能让你:
- 发送各种HTTP请求(GET、POST、PUT、DELETE…)
- 管理请求参数、Headers、Body、认证方式
- 把请求保存成集合(Collection),方便重复使用
- 自动生成代码片段(帮你直接复制成Python、JS、Java等语言的代码)
- 做自动化测试(写脚本验证返回结果)
- 模拟环境变量(开发、测试、生产环境一键切换)
简单说,它就相当于一个图形化的curl,但功能强了不知道多少倍。
下载方式
去官网下载就行,完全免费,有Windows、macOS、Linux版本。
你可能会看到它让你注册账号,别慌,注册是免费的,而且注册后可以同步你的请求集合到云端,换电脑也不怕丢。如果你特别抗拒注册,其实也支持离线使用,只是少了一些云端同步功能。
安装方法
安装就没什么技术含量了,我简单说几个注意点:
Windows:下载exe文件,双击安装,一路Next。它会自动添加到右键菜单,方便你从浏览器复制请求。
macOS:下载dmg文件,拖到Applications文件夹。第一次打开可能会提示“来自未识别开发者”,去系统设置→安全与隐私里允许运行就行。
Linux:官方提供了AppImage和Snap两种方式。我推荐用Snap,命令行一条搞定:
sudo snap install postman
装完打开,界面长这样:左边是侧边栏(你的请求集合、历史记录),中间是请求编辑器(输入URL、参数的地方),右边是响应面板(看返回数据的地方)。挺直观的。
基础使用教程
1. 发一个最简单的GET请求
打开Postman,在地址栏输入 https://api.github.com/users/octocat,点击“Send”按钮。几秒钟后,下面就会出现响应结果——JSON格式的用户信息。就这么简单。
2. 带参数和Header的POST请求
比如你要调一个登录接口:
- 选择请求方式为 POST
- 输入URL:
https://your-api.com/login - 点击“Headers”标签,添加
Content-Type: application/json - 点击“Body”标签,选择“raw”,格式选JSON,输入:
{
"username": "admin",
"password": "123456"
}
- 点Send,看返回结果
3. 把请求保存下来
每次输URL太麻烦?点击地址栏旁边的“Save”按钮,给这个请求起个名字,比如“用户登录”,然后创建一个集合(Collection)比如“我的项目API”。以后直接在左侧点击就能复用。
4. 使用环境变量
这功能太实用了。比如你有开发、测试两个环境,base URL不一样。点右上角的“环境选择器”(默认是“No Environment”),点“Manage Environments”:
- 创建一个“开发环境”,添加变量
base_url,值为http://dev-api.com - 创建一个“测试环境”,添加变量
base_url,值为http://test-api.com
然后在请求URL里写 {{base_url}}/login。切换环境时,Postman自动替换变量值,再也不用手动改URL了。
5. 查看响应数据
响应面板支持多种查看方式:
- Pretty:格式化显示JSON/XML,还能折叠节点
- Raw:原始字符串
- Preview:像浏览器一样渲染HTML
- Test Results:看测试脚本的通过情况
右上角还能看到状态码、响应时间、响应大小。接口慢不慢,一眼就知道。
进阶技巧
1. 用Pre-request Script自动生成签名
很多API需要时间戳、签名认证。你可以在请求的“Pre-request Script”标签里写JavaScript代码,自动计算签名并设置到Header里。比如:
const timestamp = Date.now();
const sign = CryptoJS.MD5(timestamp + 'secretKey').toString();
pm.request.headers.add({
key: 'X-Timestamp',
value: timestamp.toString()
});
pm.request.headers.add({
key: 'X-Sign',
value: sign
});
这样每次发送请求,都会自动计算最新的签名,不用手动改。
2. 用Tests写自动化断言
在“Tests”标签里写脚本,可以自动验证返回结果。比如:
pm.test("状态码为200", function () {
pm.response.to.have.status(200);
});
pm.test("返回数据包含token", function () {
var jsonData = pm.response.json();
pm.expect(jsonData.token).to.not.be.null;
});
点击Send后,响应面板的“Test Results”会显示通过还是失败。配合Runner功能,可以批量跑几十个接口,一键验证。
3. 用Collection Runner做批量测试
点击左上角的“Runner”按钮(或者右键集合→Run collection),选择你要跑的集合,可以设置迭代次数、延迟时间、数据文件(比如CSV里准备不同的账号密码)。跑完之后会生成一份测试报告,哪个接口挂了、响应时间多少,一目了然。做回归测试特别方便。
4. 生成代码片段
调试好接口后,点右上角的“Code”按钮(</>图标),Postman会直接生成各种语言的HTTP请求代码,包括cURL、Python requests、JavaScript fetch、Java OkHttp等等。复制到项目里直接用,省去手写请求代码的麻烦。
5. 使用Mock Server模拟后端
如果你前端开发,后端接口还没写好,可以创建Mock Server。Postman会根据你定义的请求示例,自动返回假数据。这样前端可以先跑起来,等后端接口好了再切换过去。
方法:在集合右侧点“...”,选择“Mock Server”,按提示配置即可。
6. 用Postman Interceptor抓取浏览器请求
安装Chrome扩展“Postman Interceptor”,打开后,你在浏览器里访问任何网站,发出的请求都会同步到Postman的历史记录里。调试第三方API或者分析别人网站的接口时,这招特别好用。
最后说两句
Postman这东西,刚开始你可能觉得就是个发请求的工具,用久了你会发现它其实是个API全生命周期管理平台。从开发调试、文档生成、自动化测试到监控,都能做。
我个人的建议是:别光收藏这篇文章,打开Postman,把你最近在调的一个接口放进去,然后试试保存成集合、加个环境变量、写个断言脚本。用起来,才能感受到它有多顺手。
如果你是刚入行的开发者,花半小时把Postman的基础功能摸透,以后每天都能省下不少时间。毕竟,谁都不想一遍遍在终端里敲curl命令,对吧?