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,也应重启其中已经打开的集成终端;旧终端进程不会自动读取刚写入的环境变量。
验证命令行环境
在任意普通目录运行以下命令。版本号会随安装时间变化,因此只需确认三条命令都能返回结果,并且最后一行输出固定文本。
node --version
npm --version
npx --version
node -e "console.log('Node.js 环境可用')"预期输出:
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 执行。
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 脚本运行成功");运行脚本:
node environment-check.js预期输出:
Node.js 脚本运行成功这一步比只查看版本更可靠,因为它验证了文件读取、JavaScript 解析和程序执行的完整链路。运行结束后保留该文件也可以,但后续 Tailwind CSS 项目并不依赖它。
按顺序处理典型失败
出现“找不到命令”时,先重启终端,再检查是否安装了错误的处理器架构,最后确认 Node.js 安装目录是否进入 PATH。不要一开始就反复重装,否则可能留下多个相互冲突的版本。
出现 EACCES 或“权限不足”时,不要长期依赖 sudo npm install -g。更稳妥的修复是改用版本管理器,并把依赖安装在项目本地。安装包超时或无法连接时,可先检查 npm 当前仓库和连通性。
npm config get registry
npm ping预期输出:
https://registry.npmjs.org/
npm notice PING https://registry.npmjs.org/
npm notice PONG <TIME><TIME> 表示动态耗时,实际输出可能带更多日志。若 registry 不是预期地址,应检查公司代理或此前的镜像配置;若地址正确但 npm ping 失败,再排查代理、防火墙、DNS 与证书。