Vue / 系统课时

配置本地开发环境

配置本地开发环境

本课完成 Vue 3 开发所需的本地工具配置:安装 Node.js 运行时与 npm、准备 VS Code 的 Vue 支持、启用浏览器开发者工具,并通过终端与控制台验证环境可用。

学习目标

  • 验证 Node.js、npm 与 Git 能被命令行正常调用
  • 配置适合 Vue 3 与 TypeScript 的编辑器插件
  • 使用浏览器开发者工具完成最小调试验证

安装并验证命令行工具

安装 Node.js 的当前 LTS 版本,npm 会随 Node.js 一并安装。Git 用于后续版本管理。安装完成后关闭并重新打开终端,再执行以下检查:

bash
node --version
npm --version
git --version

预期输出:

text
v<MAJOR>.<MINOR>.<PATCH>
<NPM_VERSION>
git version <GIT_VERSION>

版本号会随安装时间不同而变化。三条命令都应返回版本信息;若出现 command not found 或“不是内部或外部命令”,说明安装目录尚未进入 PATH,应先重启终端,再检查安装选项和环境变量。

项目中只固定使用一种包管理器。本课程使用 npm,因此后续提交 package-lock.json,不要同时生成 pnpm-lock.yaml 或 yarn.lock。

配置 VS Code

在 VS Code 的扩展面板安装 Vue - Official 与 ESLint。Vue - Official 为 Vue 单文件组件提供 TypeScript 类型提示、模板补全和语法检查;若已安装旧版 Vetur,应在 Vue 3 工作区禁用,避免语言服务冲突。

VS Code 扩展安装位置

安装后打开设置,确认文件保存时不会同时由多个格式化器重复处理。当前阶段保持默认格式化行为即可,代码风格会在项目创建后由 ESLint 配置统一约束。

验证浏览器调试工具

Chrome、Edge 等 Chromium 浏览器内置开发者工具。Windows 或 Linux 可按 F12 或 Ctrl+Shift+I,macOS 可按 Command+Option+I。打开 Console 面板后执行:

js
console.log('devtools-ready')

预期输出:

text
devtools-ready

能看到该文本,说明控制台可执行 JavaScript。后续调试管理后台时,Console 用于查看运行错误,Network 用于检查接口请求,Elements 用于定位页面结构和样式。

处理典型失败

Node.js 版本过低时,创建项目或启动 Vite 会直接提示版本不满足要求。不要通过降级 Vite 绕过,应升级到仍受支持的 Node.js LTS 版本后重新安装依赖。

若终端能执行 node,但 VS Code 集成终端不能执行,通常是 VS Code 启动时尚未读取新的环境变量。完全退出并重新打开 VS Code,再创建一个新的集成终端。

若 Vue 文件没有类型提示,先确认 Vue - Official 已在当前工作区启用,再检查 Vetur 是否仍处于启用状态。插件调整后执行“Developer: Reload Window”重新加载窗口。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置本地开发环境

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

登录哪都通