2026/5/21 9:28:56
网站建设
项目流程
瑞安公司做网站,网站改版 html,钉子wordpress主题,搭建直播网站需要怎么做Vue CLI 作为 Vue 官方提供的脚手架工具#xff0c;是前端开发者高效搭建 Vue 项目、管理项目配置和扩展功能的核心利器。它简化了项目初始化流程#xff0c;标准化了配置结构#xff0c;还通过丰富的插件生态让项目扩展变得灵活可控。本文将从项目创建、核心配置文件解析、…Vue CLI 作为 Vue 官方提供的脚手架工具是前端开发者高效搭建 Vue 项目、管理项目配置和扩展功能的核心利器。它简化了项目初始化流程标准化了配置结构还通过丰富的插件生态让项目扩展变得灵活可控。本文将从项目创建、核心配置文件解析、插件使用三大维度全面拆解 Vue CLI 的使用方法帮助你彻底掌握这一必备工具。一、Vue CLI 基础安装与项目创建1. 环境准备使用 Vue CLI 前需确保本地已安装 Node.js推荐 14.18 版本和 npm/yarn。Node.js 自带 npm 包管理器可通过以下命令验证安装# 检查 Node.js 版本 node -v # 检查 npm 版本 npm -v2. 安装 Vue CLI通过 npm 全局安装 Vue CLI若已安装旧版本需先卸载npm uninstall -g vue-clinpm install -g vue/cli # 或使用 yarn yarn global add vue/cli安装完成后验证版本vue --version # 简写vue -V3. 创建新项目Vue CLI 提供两种创建方式交互式命令行推荐和图形化界面满足不同开发习惯。方式 1交互式命令行创建执行以下命令按提示完成项目配置vue create my-vue-project关键配置项说明选择预设可选择Default ([Vue 3] babel, eslint)Vue 3 默认配置、Default ([Vue 2] babel, eslint)Vue 2 默认配置或Manually select features手动选择功能。手动选择功能核心Babel语法转译兼容低版本浏览器TypeScript支持 TypeScript 开发Progressive Web App (PWA)PWA 应用支持RouterVue 路由Vuex/Pinia状态管理Vue 3 推荐 PiniaCSS Pre-processorsCSS 预处理器Less/Sass/Scss/StylusLinter / Formatter代码检查与格式化ESLint Prettier 等Unit Testing单元测试Jest/MochaE2E Testing端到端测试Cypress/nightwatch。其他配置选择 Vue 版本2 或 3路由是否启用 history 模式CSS 预处理器类型ESLint 校验规则如 Standard/Prettier校验时机保存时 / 提交时配置文件存放位置单独文件 / 合并到 package.json是否保存为预设方便后续复用。方式 2图形化界面创建Vue CLI 提供可视化配置界面操作更直观vue ui执行后会自动打开浏览器默认地址http://localhost:8000按界面指引点击「创建」→ 选择项目目录 → 输入项目名称选择预设或手动配置功能与命令行一致完成配置后点击「创建项目」等待依赖安装完成。4. 启动与预览项目项目创建完成后进入项目目录并启动开发服务器cd my-vue-project # 启动开发服务 npm run serve # 或 yarn serve启动成功后访问控制台输出的地址如http://localhost:8080即可看到 Vue 初始页面。二、核心配置文件解析Vue CLI 项目的配置分为「基础配置文件」和「自定义配置文件」核心文件结构如下my-vue-project ├── node_modules # 项目依赖 ├── public # 静态资源不会被 webpack 处理 │ ├── favicon.ico # 网站图标 │ └── index.html # 入口 HTML 文件 ├── src # 项目源码 │ ├── assets # 静态资源会被 webpack 处理 │ ├── components # 公共组件 │ ├── router # 路由配置可选 │ ├── store # 状态管理可选 │ ├── views # 页面组件可选 │ ├── App.vue # 根组件 │ └── main.js # 入口 JS 文件 ├── .eslintrc.js # ESLint 配置可选 ├── .gitignore # Git 忽略文件 ├── babel.config.js # Babel 配置 ├── package.json # 项目依赖与脚本 ├── README.md # 项目说明 └── vue.config.js # Vue CLI 自定义配置核心1. 核心配置文件vue.config.js这是 Vue CLI 最关键的自定义配置文件默认不存在需手动创建用于覆盖默认配置支持 webpack、devServer 等核心配置的自定义。以下是常用配置示例const { defineConfig } require(vue/cli-service) module.exports defineConfig({ // 基本路径部署时的根路径 publicPath: process.env.NODE_ENV production ? /my-project/ : /, // 输出目录打包后的文件夹 outputDir: dist, // 静态资源目录相对于 outputDir assetsDir: assets, // 是否开启源码映射生产环境建议关闭 productionSourceMap: false, // 开发服务器配置 devServer: { port: 8081, // 端口号 open: true, // 自动打开浏览器 proxy: { // 接口代理解决跨域 /api: { target: http://localhost:3000, // 后端接口地址 changeOrigin: true, // 开启跨域 pathRewrite: { ^/api: } // 重写路径 } } }, // CSS 相关配置 css: { loaderOptions: { // 全局注入 SCSS 变量 scss: { additionalData: import /assets/styles/variables.scss; } } }, // webpack 配置链式操作 chainWebpack: config { // 配置别名 config.resolve.alias .set(, resolve(src)) .set(components, resolve(src/components)) // 移除 prefetch 插件减少首屏加载资源 config.plugins.delete(prefetch) }, // webpack 配置直接修改 configureWebpack: { plugins: [ // 自定义 webpack 插件 ], resolve: { extensions: [.js, .vue, .json, .ts] } } }) // 辅助函数路径解析 function resolve(dir) { return require(path).join(__dirname, dir) }2. 其他关键配置文件babel.config.jsBabel 转译配置默认已适配 Vue 语法可自定义预设如babel/preset-env和插件package.json管理项目依赖dependencies生产依赖、devDependencies开发依赖和脚本serve/build/lint等.eslintrc.jsESLint 代码校验规则配置可自定义规则、忽略文件.eslintignorepublic/index.html项目入口 HTML可通过% htmlWebpackPlugin.options.title %动态注入标题。三、Vue CLI 插件使用扩展项目功能Vue CLI 的插件生态是其核心优势插件可快速集成第三方功能如 UI 库、路由、状态管理、自动化部署等支持「项目创建时安装」和「项目创建后手动安装」。1. 插件的基本使用方式方式 1创建项目时安装在交互式命令行中选择「Manually select features」即可勾选所需插件如 Router、Vuex、ESLint 等Vue CLI 会自动完成安装和配置。方式 2项目创建后安装通过vue add命令安装官方 / 社区插件示例# 安装 Vue Router 插件 vue add router # 安装 Vuex 插件Vue 3 推荐 Pinia需手动安装npm install pinia vue add vuex # 安装 Element Plus 插件Vue 3 UI 库 vue add element-plus # 安装 ESLint 插件 vue add eslint2. 常用插件示例1UI 库插件Element Plus安装后Vue CLI 会自动配置按需引入 / 全局引入无需手动修改 main.jsvue add element-plus安装时会提示选择引入方式Fully import全局引入/按需引入是否配置主题Yes/No。2PWA 插件vue/cli-plugin-pwa实现网页离线访问、添加到桌面等 PWA 特性vue add pwa安装后会自动生成src/registerServiceWorker.js并在public目录添加 PWA 图标和配置文件只需在vue.config.js中配置 PWA 选项module.exports defineConfig({ pwa: { name: My Vue App, shortName: Vue App, manifestOptions: { display: standalone } } })3TypeScript 插件vue/cli-plugin-typescript为项目添加 TypeScript 支持vue add typescript安装后会自动生成tsconfig.json并将main.js改为main.ts同时修改组件后缀为.vue TypeScript 语法如script setup langts。3. 自定义插件进阶若社区插件无法满足需求可开发自定义 Vue CLI 插件。插件本质是一个包含generator.js生成文件和index.js注册命令 / 修改配置的 npm 包核心步骤创建插件目录结构my-vue-plugin ├── generator.js # 生成文件如配置、组件 ├── index.js # 插件入口 └── package.json # 插件配置在generator.js中定义文件生成逻辑module.exports (api, options, rootOptions) { // 向 src 目录添加自定义组件 api.render(./template, { name: options.name }) // 修改 package.json添加依赖 api.extendPackage({ dependencies: { my-dependency: ^1.0.0 } }) }发布插件到 npm然后通过vue add my-vue-plugin安装使用。四、Vue CLI 进阶技巧环境变量配置创建.env.development开发环境、.env.production生产环境文件定义环境变量以VUE_APP_开头如VUE_APP_API_BASE_URLhttp://localhost:3000在代码中通过process.env.VUE_APP_API_BASE_URL访问多环境打包在package.json中配置脚本如build:test: vue-cli-service build --mode test对应.env.test配置文件清除缓存若配置修改不生效执行vue-cli-service clear清除缓存升级 Vue CLI执行npm update -g vue/cli升级全局 CLI项目内执行vue upgrade升级项目依赖的插件。五、总结Vue CLI 从项目初始化、配置管理到插件扩展为 Vue 项目提供了一站式的工程化解决方案。掌握项目创建的两种方式理解vue.config.js的核心配置灵活运用插件扩展功能能大幅提升 Vue 项目的开发效率和可维护性。随着 Vue 3 和 Vite 的普及Vue CLI 虽不再是唯一选择但在中大型项目、团队标准化开发场景中仍有不可替代的优势。结合本文的配置示例和插件使用方法你可以快速搭建符合业务需求的 Vue 项目架构。