第一个 JS 程序:在浏览器控制台和 Node 中分别运行

学任何一门编程语言,第一步都不是背语法,而是先让一行代码跑起来、看到结果。这个"闭环"一旦建立,后面所有的学习都是在往这个闭环里添砖加瓦。

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. 不会再自动回显 。表达式 1 + 2 写在文件里,不调用 console.log 是看不到结果的。

  2. 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。先看报错里"什么未定义",再判断这个对象属于哪个环境。

九、起步建议

第一篇文章不追求掌握多少语法,先把这三件事做扎实:

  1. 两个环境都要跑通 :浏览器控制台打印、Node 运行 .js 文件,各来一遍。

  2. 认识报错:故意写几个错的,看看报错长什么样,别怕红字。

  3. 形成习惯:遇到不懂的表达式,扔进控制台或 REPL 里跑一下,这比查资料快。

结语

"第一个程序"的意义不在于代码有多复杂,而在于你亲手打通了"写---运行---看结果"这条链路。这条链路一旦建立,后面所有的学习都有了落脚点:写错了会报错、写对了会输出,你可以用肉眼验证自己的理解。

浏览器和 Node 是同一门语言的两个落脚点。控制台让你低成本试错,Node 让你把代码带出浏览器。两者都跑过一遍之后,你会发现那句"语言一样,宿主不同"不再是一句空话,而是你能亲手复现的事实。

现在,打开控制台,输入 1 + 1 回车,然后试着把它改成 console.log(1 + 1),再把它存成 first.js 用 node first.js 跑一次。这三步走完,你就算是真正"开始"了。

相关推荐
Evand J1 小时前
【MATLAB例程】二维IMM-UKF定位,基于四个基站的AOA与测距辅助
开发语言·matlab
feixing_fx1 小时前
变量与声明:let、const、var 的选择边界
开发语言·前端·javascript·前端框架
程序员大阳2 小时前
副队长Vue3教程(8)--列表渲染 v-for
javascript·vue3·v-for·列表渲染
个 人 练 习 生2 小时前
C++:从零基础到深入了解vector的使用
开发语言·c++·经验分享·学习·程序人生·stl
H.莓飛3 小时前
【C++】【STL】stack_OJ题
服务器·c语言·开发语言·数据结构·c++·算法·visual studio
hudd6683 小时前
JavaEE 初阶 - 文件操作和IO
java·开发语言·java-ee
JavaGuide4 小时前
Cloudflare 开源的这套神级安全审计 Skill 太好用了!
前端·后端
starzy19904 小时前
深入理解Scala隐式参数:上下文流转
开发语言·python·scala
孟健5 小时前
用 unslop 拯救 AI 生成网页的塑料感,7 分钟重构落地实测
前端·人工智能·ai编程