为什么在代码之前先卡在扩展名上
学习氛围编程的人,会在代码之前先卡住的地方,是文件扩展名。当 .json、.yaml、.env、.md 这类陌生扩展名扑面而来时,他们便以「果然我不是开发者」放弃了。然而这数十种格式只分三类。
装数据的容器、在屏幕上呈现的东西、设置与机密。只要抓住这三条分支,即使是从没见过的扩展名,也能大致感觉到它属于哪个盒子。下表就是那张地图。
| 格式 | 分类 | 一句话定义 |
|---|---|---|
| CSV | 数据 | 去掉一切格式的电子表格 |
| JSON | 数据 | 贴了标签的盒子(应用与 AI 的通用语) |
| XML | 数据 | 用标签包裹的旧式数据 |
| HTML | 画面 | 网页的骨架 |
| Markdown (.md) | 画面 | 用几个符号排版的文字 |
| YAML | 设置 | 用缩进整理的设置 |
| .env | 机密 | 存放 API 密钥与密码的保险箱 |
| TXT | 其他 | 毫无规则的纯字符 |
装数据的格式:CSV、JSON、XML
CSV 是去掉所有颜色与格式、用逗号分隔各列的纯表格。第一行是列名,从下一行起是数据。从商城下载的订单记录或问卷结果通常就是 CSV,直接交给 AI 分析也很方便。
JSON 是当今程序之间交换数据的事实标准。每个值都带着标签,还能在盒子里再套盒子。AI API 的响应、应用的设置、数据库的结果几乎都是 JSON,所以氛围编程时最常遇到它。
XML 是把同样的数据用一开一合的标签包裹起来的旧方式。政府机关和银行的老系统里仍在使用,有趣的是,把 Excel 文件(.xlsx)拆开来看,里面就是 XML。新做项目时,人们通常会选更轻的 JSON。
呈现的格式:HTML、Markdown
HTML 是浏览器绘制画面的蓝图。标签指定「这是什么」——<h1> 是标题、<p> 是段落、<button> 是按钮。用氛围编程做出的网站或邮件通讯全是 HTML,骨架(HTML)、装饰(CSS)、动作(JavaScript)作为一套一起运作。
Markdown (.md) 是用 # 或 - 这类简单符号来表现排版的文字。学习只需五分钟,带着符号也能读懂,渲染后就成为整洁的文档。GitHub 的 README、AI 聊天机器人的回答、Notion 备忘录大多是 Markdown。
设置与机密:YAML、.env
YAML 是与 JSON 相同的数据,用缩进代替括号来整理。它对人类友好,因此常用于部署设置和应用环境配置。只是要当心:错一个空格就会整体崩坏,务必留意缩进。
.env 是把 API 密钥、密码等敏感值与代码分离存放的文件。接入 AI 服务时,密钥就放在这里。有一条铁律:绝不能把 .env 推送到公开仓库。那等于把整把钥匙交给陌生人。因此通常用 .gitignore 将其排除。
只看扩展名就能有感觉的方法
核心直觉很简单。CSV、JSON、XML、YAML 是数据,即内容物。HTML、Markdown 是呈现的文字与画面。.env 是机密。只要一看扩展名就有「这是数据、这是画面、这是设置」的感觉,就足够了。
从 AX(AI 转型)的角度看,这种直觉比想象中重要。非开发者用 AI 做东西时,真正的障碍往往不是代码语法,而是对陌生文件的模糊恐惧。当你握住把扩展名分成三类的地图,陌生文件便不再可怕。氛围编程,正是从那一刻真正开始。