HTML / CSS / 系统课时

准备 Node.js 开发环境

准备 Node.js 开发环境

本课完成 Node.js、npm 与 npx 的安装和验证,并通过一个最小脚本确认运行时、包管理器和终端路径都可用。完成后,你将拥有可直接用于安装 Tailwind CSS 及其他前端工具的命令行环境。

学习目标

  • 选择适合前端学习的 Node.js 安装方式。
  • 验证 node、npm 与 npx 命令能够正常执行。
  • 按固定顺序定位路径、权限和网络类安装问题。

选择安装方式

Node.js 是 JavaScript 运行时,npm 负责安装和管理项目依赖,npx 用于直接运行 npm 包提供的命令。初学阶段应选择官方仍在支持的 LTS 分支,不必追逐 Current 分支;Node.js 官方下载页会标明当前 LTS。:contentReference[oaicite:0]{index=0}

只有一个学习项目时,可使用官方安装包并保留默认选项。需要在多个项目之间切换 Node.js 版本时,优先使用版本管理器;npm 官方也推荐这种方式,因为它便于升级、回退,并能减少全局安装时的权限问题。:contentReference[oaicite:1]{index=1}

安装并刷新终端

Windows 与 macOS 可从 Node.js 官方下载页取得对应系统和处理器架构的 LTS 安装包。安装时保留 npm 与 PATH 相关选项。Linux 更适合按所用发行版或版本管理器的官方说明安装,避免直接复制来源不明的脚本。

安装完成后关闭并重新打开终端,使新的 PATH 生效。若使用 VS Code,也应重启其中已经打开的集成终端;旧终端进程不会自动读取刚写入的环境变量。

验证命令行环境

在任意普通目录运行以下命令。版本号会随安装时间变化,因此只需确认三条命令都能返回结果,并且最后一行输出固定文本。

bash
node --version
npm --version
npx --version
node -e "console.log('Node.js 环境可用')"

预期输出:

text
v<MAJOR>.<MINOR>.<PATCH>
<MAJOR>.<MINOR>.<PATCH>
<MAJOR>.<MINOR>.<PATCH>
Node.js 环境可用

第一行带 v 的版本来自 Node.js,后两行分别来自 npm 与 npx。实际版本数字可能不同;若命令均正常结束,说明运行时和包管理工具已经进入当前终端的 PATH。

运行一个最小脚本

新建 environment-check.js,写入完整脚本。它同时读取 Node.js 版本、当前平台和工作目录,可用于确认脚本确实由本机 Node.js 执行。

js
const result = {
  nodeVersion: process.version,
  platform: process.platform,
  cwdAvailable: process.cwd().length > 0,
};

// 只断言稳定条件,避免把不同系统的路径写死。
if (!result.nodeVersion.startsWith("v") || !result.cwdAvailable) {
  throw new Error("Node.js 环境检查失败");
}

console.log("Node.js 脚本运行成功");

运行脚本:

bash
node environment-check.js

预期输出:

text
Node.js 脚本运行成功

这一步比只查看版本更可靠,因为它验证了文件读取、JavaScript 解析和程序执行的完整链路。运行结束后保留该文件也可以,但后续 Tailwind CSS 项目并不依赖它。

按顺序处理典型失败

出现“找不到命令”时,先重启终端,再检查是否安装了错误的处理器架构,最后确认 Node.js 安装目录是否进入 PATH。不要一开始就反复重装,否则可能留下多个相互冲突的版本。

出现 EACCES 或“权限不足”时,不要长期依赖 sudo npm install -g。更稳妥的修复是改用版本管理器,并把依赖安装在项目本地。安装包超时或无法连接时,可先检查 npm 当前仓库和连通性。

bash
npm config get registry
npm ping

预期输出:

text
https://registry.npmjs.org/
npm notice PING https://registry.npmjs.org/
npm notice PONG <TIME>

<TIME> 表示动态耗时,实际输出可能带更多日志。若 registry 不是预期地址,应检查公司代理或此前的镜像配置;若地址正确但 npm ping 失败,再排查代理、防火墙、DNS 与证书。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

准备 Node.js 开发环境

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通