1. 让工具跑出第一行结果

约 20 分钟难度：新手动手章

上一章把想做的事拆成了一句问题陈述。要让这句话变成能运行的东西，先得有一套彼此连上的工具：一个写字和下指令的地方，一个真正把代码跑起来的地方，一个记住每次改动的地方。

这一章不解决任何业务问题，只做一件事：把这三样东西装好，再跑一条检查命令，让机器给出第一行回应。这一行回应是「整条链路已经接通」的信号，离最终产品还很远。

三个角色：编辑、运行、保存历史

工具的名字会换，角色相对稳定。这本书从头到尾只依赖三个角色：

三样都到各自官网下载安装即可。不用记版本号，官网默认推荐的稳定版本就够用；安装过程各个系统略有差别，跟着官网页面上的指引走完就好。这本书不复述那几步点击，因为下载入口、按钮位置和版本号都会变，写进正文很快就对不上，而角色和它们之间的关系不会变。

装完之后不用急着判断「装对了没有」。对错不靠回忆安装步骤来确认，靠下一节那条检查命令。

本书准备了一个起始项目，里面只有一个不碰任何业务的检查脚本：

// 这段脚本不做任何业务，只负责证明「运行环境能把代码跑起来」
console.log('报价整理器：环境就绪，可以开始了');

在 CodeBuddy 里打开 quote-tools 文件夹，打开内置终端，进入这个目录后运行：

node check.mjs

终端会打印出固定的一行：

报价整理器：环境就绪，可以开始了

看到这一行，说明三个角色已经连上：CodeBuddy 编辑并发出了指令，Node.js 把脚本执行了出来，之后的每次改动会交给 Git 记录。这一行就是这一章要的第一个结果，它证明的是这条从「下指令」到「看到回应」的链路已经通了，跟业务写得对不对无关。

检查命令没有打印出那一行，而是弹出一段报错，先别改任何代码。按「看到什么、说明什么、下一步做什么」三段对照，多数情况能自己接上：

看到什么	说明什么	下一步做什么
提示找不到 `node` 这个命令	运行环境没装好，或者装完没重开终端	回官网确认 Node.js 已安装，关掉终端重新打开再跑一次
提示找不到 `check.mjs` 这个文件	终端当前不在 `quote-tools` 目录里	先进入这个目录，确认能看到 `check.mjs`，再运行命令
打印出别的报错文字	脚本被改动过，或复制时缺了字符	把 `check.mjs` 恢复成书里这一份，只留那一行 `console.log`

三段式的重点不在于记住每一种报错，而是一个固定顺序：先看提示里说「找不到什么」，再判断是环境、位置还是文件本身的问题，最后只动那一处。这套顺序在后面每一次运行出错时都用得上。

这一章留下两样东西。

一样是能在本机重复运行的起始项目：只要 node check.mjs 还能打印出那一行，环境就是好的，随时可以从这里往下走，不用重新怀疑工具。

另一样是一个做法：每次换机器、换环境，先跑一遍检查命令，确认链路通了再写业务。这个做法在第 14 章把东西部署到真实环境时，会以另一种形式再用一次。