学任何一门编程语言,第一步都不是背语法,而是先让一行代码跑起来、看到结果。这个"闭环"一旦建立,后面所有的学习都是在往这个闭环里添砖加瓦。
JavaScript 有个天然优势:你不需要安装任何东西,就能在浏览器里写第一行代码。等你想让它离开浏览器,再去装 Node 也不迟。今天我们就把这两条路都走一遍,顺便弄清楚"运行"这件事到底意味着什么。
一、先理解"运行"是什么
写代码和运行代码是两回事。你敲下的是一段文本,它本身没有任何作用;只有当某个引擎读取这段文本、解析成指令、一条条执行,才会有"结果"。
所以运行 JS 需要一个载体。今天介绍的两种载体:
| 载体 | 你写代码的地方 | 谁来执行 | 适合场景 |
|---|---|---|---|
| 浏览器控制台 | 浏览器自带的 Console 面板 | 浏览器的 JS 引擎 | 快速试错、调试页面 |
| Node.js | 终端或代码编辑器里的 .js 文件 |
V8 引擎 | 写脚本、跑服务、做工具 |
两者的语言是一样的,只是宿主不同。先用浏览器上手,是因为它零成本;再切到 Node,是为了理解"离开浏览器"之后的样子。
二、在浏览器控制台里运行第一行代码
1. 打开控制台
以 Chrome 为例,有三种方式,任选其一:
-
按
F12或Ctrl + Shift + I(Mac 上是Cmd + Option + I) -
右键页面任意位置,选择"检查"
-
菜单 → 更多工具 → 开发者工具
打开后,顶部有一排标签:Elements、Console、Sources、Network......点 Console(中文版叫"控制台")。
Firefox、Edge、Safari 也都有类似的面板。Safari 需要先在"设置 → 高级"里勾选"显示网页开发者功能",才会出现开发菜单。具体菜单名称各版本可能略有差异,以你本地实际为准。
2. 敲下第一行
在 Console 最下方的输入行里,输入:
javascript
1 + 2
回车,下面立刻出现一个 3。
恭喜,你完成了第一个 JS 程序。这里发生的事是:浏览器引擎读取了 1 + 2,求值为 3,然后把结果打印回控制台。
再做几个小实验:
javascript
'hello' + ' world' // "hello world"
10 / 4 // 2.5
true && false // false
你会发现控制台有个很方便的特性:输入一个表达式,它会自动把结果打印出来。这让你可以像用计算器一样试各种东西。
3. 用 console.log 主动输出
上面是控制台"自动回显"结果。但真正写代码时,我们更常用 console.log 主动打印:
javascript
console.log('你好,JavaScript')
console.log(1 + 2, '两个值可以一起打印')
区别在于:自动回显只对"你直接输入的表达式"生效;而 console.log 是代码里主动调用的函数,写进文件里、被别的函数调用时都能用。后面进了 Node,自动回显就没了,console.log 才是通用手段。
4. 在控制台里操作页面
控制台最爽的地方是它直接连着当前页面。试试:
javascript
document.title
document.title = '标题被我改了'
看一眼浏览器标签页,标题变了。再试试:
javascript
document.body.style.background = 'pink'
页面背景立刻变粉。
这种"改一行、立刻看到效果"的反馈,是控制台最大的价值。初学阶段多在这里玩,比闷头看文档有效得多。
5. 控制台的几个实用技巧
javascript
// 1. 上下方向键调出历史命令,不用重复敲
// 2. Tab 键自动补全
// 3. Shift + Enter 换行,写多行代码
// 4. 清屏:Ctrl + L 或输入 clear()
还有一个小细节:控制台里 $0 代表你在 Elements 面板里当前选中的元素。选中一个节点,回到 Console 输入 $0,就能拿到它。调试页面时非常顺手。
三、把代码写进文件:从控制台到 HTML
控制台适合试错,但代码总得存下来。最直接的方式是建一个 HTML 文件:
html
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>我的第一个 JS 页面</title>
</head>
<body>
<h1>看看控制台</h1>
<script>
console.log('这行来自 HTML 里的 script 标签')
document.querySelector('h1').textContent = '标题被 JS 改了'
</script>
</body>
</html>
保存为 index.html,双击用浏览器打开,再按 F12 看 Console。你会看到打印信息,页面上的标题也被改了。
这里有个关键点:<script> 放在 <body> 末尾,是为了确保它执行时,上面的 <h1> 已经存在。如果把脚本放到 <head> 里、又直接操作 h1,就会拿到 null 报错。这是新手最常踩的坑之一。
想验证的话,把 <script> 挪到 <head> 里试试:
javascript
document.querySelector('h1') // null
null.textContent 自然会报错。理解"执行时机"这件事,从这里开始。
四、安装 Node.js 并在终端运行
浏览器里跑通了,接下来换个环境。
1. 安装
去 Node.js 官网下载 LTS(长期支持)版本,按安装向导走完即可。安装完成后,打开终端(Windows 用 PowerShell 或 CMD,Mac 用 Terminal),输入:
bash
node -v
能看到版本号(形如 v20.x.x 或更高)就说明装好了。具体版本号以你安装的为准,不必和示例一致。
2. 用 REPL 快速试错
直接在终端输入 node 回车,会进入一个叫 REPL 的交互环境(Read-Eval-Print Loop,读入---求值---打印---循环):
bash
$ node
> 1 + 2
3
> 'hello' + ' world'
'hello world'
> .exit
它和浏览器控制台很像,区别是:这里没有 document、没有 window,只有 Node 提供的能力。你可以试试:
javascript
> document
// ReferenceError: document is not defined
这个报错就是"宿主不同"最直观的证据。语言还是那门语言,只是脚下的地面换了。
输入 .exit 或按两次 Ctrl + C 退出 REPL。
3. 写一个 .js 文件运行
REPL 适合临时验证,正式代码还是要写进文件。新建一个 hello.js:
javascript
console.log('Hello from Node.js')
const name = 'JavaScript'
console.log(`你好,${name}`)
console.log('当前 Node 版本:', process.version)
在终端里,切到这个文件所在的目录,执行:
bash
node hello.js
终端会依次打印三行结果。
注意两个细节:
-
不会再自动回显 。表达式
1 + 2写在文件里,不调用console.log是看不到结果的。 -
process是 Node 特有的全局对象,浏览器里没有。它携带了运行时信息,比如版本号、环境变量、命令行参数。
五、两个环境的对比:把差异摆清楚
跑到这里,你已经亲手体验了两种宿主。用一张表收个尾:
| 维度 | 浏览器控制台 | Node.js |
|---|---|---|
| 执行引擎 | 各浏览器自带(V8/SpiderMonkey/JSC) | V8 |
| 页面相关 API | document、window、localStorage |
没有 |
| 系统相关 API | 受限(不能随意读写文件) | fs、http、process |
| 结果回显 | 输入表达式自动打印 | 必须 console.log |
| 代码入口 | <script> 标签或控制台 |
.js 文件 + node 文件名 |
| 典型用途 | 调试页面、试语法 | 脚本、服务、构建工具 |
一句话概括:语言一样,能力不同 。你在浏览器里写 document.title,在 Node 里就得换成 fs.readFileSync。这不是语法差异,是宿主差异。
六、第一个程序常见的报错与排查
刚开始一定会遇到报错,这不是坏事。下面几个是高频的,提前认识一下:
1. xxx is not defined
javascript
console.log(userName)
// ReferenceError: userName is not defined
变量没声明就用了。检查拼写,或者确认有没有 let / const 声明。
2. Cannot read properties of null
javascript
document.querySelector('#not-exist').textContent = 'hi'
// TypeError: Cannot read properties of null
选择器没找到元素,返回了 null,再访问它的属性就报错。常见原因:选择器写错、脚本执行太早、DOM 还没加载完。
3. document is not defined
在 Node 里用了浏览器 API。要么换成 Node 的写法,要么确认代码该跑在哪个环境。
4. SyntaxError: Unexpected token
语法写错了,比如少个括号、少个引号。控制台会指明行号,顺着找。
排查报错的三步:看错误类型 → 看报错行号 → 看上下文代码。多数问题在这三步内都能定位,剩下的再交给断点和日志。
七、从"跑起来"到"会调试"
会运行只是起点,会调试才是真本事。两个最基础的工具,现在就可以用起来。
1. console 家族
javascript
console.log('普通信息')
console.warn('警告')
console.error('错误')
console.table([{ a: 1, b: 2 }, { a: 3, b: 4 }])
console.time('loop')
for (let i = 0; i < 100000; i++) {}
console.timeEnd('loop')
console.table 打印数组和对象特别清晰,console.time / timeEnd 用来快速测耗时。这些在浏览器和 Node 里都能用。
2. 断点
在浏览器 DevTools 的 Sources 面板里,找到你的 JS 文件,点击行号就能下断点。刷新页面,代码执行到那一行会暂停,你可以鼠标悬停在变量上看值、在 Console 里临时求值、按 F10 单步执行。
Node 里也能调试,加 --inspect 参数启动后,在 Chrome 里打开 chrome://inspect 就能连上。这个稍微进阶,第一篇文章先知道有这么回事即可。
八、初学者常见疑问
问:我一定要装 Node 吗?
只想学语法和 DOM,浏览器控制台够了。但如果要学工程化、跑 npm、写构建配置,Node 是必需品,早装早习惯。
问:控制台里能写多行吗?
能。按 Shift + Enter 换行。不过太长的代码还是建议写进文件,控制台更适合临时代码。
问:为什么我在控制台里定义的变量,刷新页面就没了?
控制台是临时环境,刷新页面等于重置。要保留代码,就写进 .js 文件。
问:Node 里能用 alert 吗?
不能。alert 是浏览器提供的弹窗 API,Node 没有界面。想输出信息,用 console.log。
问:为什么同一段代码,我在浏览器能跑,Node 里报错?
九成是用到了宿主特有的 API。先看报错里"什么未定义",再判断这个对象属于哪个环境。
九、起步建议
第一篇文章不追求掌握多少语法,先把这三件事做扎实:
-
两个环境都要跑通 :浏览器控制台打印、Node 运行
.js文件,各来一遍。 -
认识报错:故意写几个错的,看看报错长什么样,别怕红字。
-
形成习惯:遇到不懂的表达式,扔进控制台或 REPL 里跑一下,这比查资料快。
结语
"第一个程序"的意义不在于代码有多复杂,而在于你亲手打通了"写---运行---看结果"这条链路。这条链路一旦建立,后面所有的学习都有了落脚点:写错了会报错、写对了会输出,你可以用肉眼验证自己的理解。
浏览器和 Node 是同一门语言的两个落脚点。控制台让你低成本试错,Node 让你把代码带出浏览器。两者都跑过一遍之后,你会发现那句"语言一样,宿主不同"不再是一句空话,而是你能亲手复现的事实。
现在,打开控制台,输入 1 + 1 回车,然后试着把它改成 console.log(1 + 1),再把它存成 first.js 用 node first.js 跑一次。这三步走完,你就算是真正"开始"了。