资讯详情

开始使用 VUX 之前:前置知识、工具链与工程化准备

📅 2026/9/21 3:03:53 | 华诺云谱 👁 阅读
开始使用 VUX 之前:前置知识、工具链与工程化准备
UI组件前端【免费下载链接】vuxMobile UI Components based on Vue WeUI项目地址https://gitcode.com/gh_mirrors/vu/vux点击查看免费下载在正式使用 VUXVue WeUI 移动端 UI 组件库之前你不需要是一位资深前端工程师但至少应具备Vue的基础使用能力并对Node.js、npm、cnpm、yarn等工具有一定的了解。本文以 VUX 官方《开始使用 VUX 之前》文档为主线结合仓库源码系统梳理上手 VUX 所需的知识储备、工具链组成WeUI、Vue、Webpack、vue-cli、vue-loader、vux-loader以及从安装到调用的完整路径帮助你快速判断自己是否已准备好进入 VUX 开发。写在前面这份准备清单针对谁VUX 官方在文档开头给出了一个非常务实的提醒如果你刚从后端转到前端可能会被前端表象上的工程复杂度吓到——但请放心使用vue-cli从模板创建项目你只需要几条简单的命令就能开始编码和构建。这段话点明了 VUX 的使用前提VUX 不是零基础入门教程它假设你已经会用 Vue并且接触过前端工程化工具。官方文档明确列出两条硬性要求至少已经会使用Vue大概了解Node.js、npm、cnpm、yarn这些东西。同时文档给出了一个明确的版本建议建议Node.js版本在7.6.0以上。这一点可以在仓库 package.json 中得到印证——当前仓库声明的最低运行环境为node 4.0.0、npm 3.0.0见engines字段而官方文档建议的7.6.0是针对日常开发体验的更高标准例如async/await在该版本已默认可用。如果你使用的是更现代的 Node LTS 版本自然完全满足要求。相关工具全景一条完整的 Vue 工程化链路官方文档将上手 VUX 需要了解的工具归纳为六个WeUI、Vue、Webpack、vue-cli、vue-loader、vux-loader。它们共同构成了一条从样式基础到组件库加载的完整链路。下面逐一展开。WeUIVUX 的样式基底VUX 的样式基于WeUI微信官方网页设计规范样式库但两者是解耦的你不必为了使用 VUX 而单独去引入 WeUI对于简单的页面你完全可以直接引入 WeUI 样式而不用 VUX。也就是说WeUI 是 VUX 的设计语言源头VUX 把 WeUI 的视觉规范封装成了 Vue 组件。这一点可以从仓库的目录结构直接观察到src/styles 下存放了 77 个.less样式文件其中 src/styles/variable.less 集中定义了全部主题变量如theme-color: #04BE02、actionsheet-label-primary-color: #1AAD19等这套变量的语义与 WeUI 的绿色主色、警示红色等规范一脉相承。后续如果你想换主题色改这套变量即可后文 vux-loader 的less-theme插件正是围绕它工作的。Vue组件库的运行时基础VUX 是基于Vue的组件库这意味着你需要有Vue的基础知识——这是使用 VUX 的绝对前提没有任何绕过方式。组件本质上是 Vue 组件插件如AlertPlugin、ToastPlugin本质上是 Vue 插件用法完全遵循 Vue 2 的组件与插件体系。从仓库看VUX 当前依赖 Vue 2.x 生态package.json 中vue与vue-template-compiler版本均为2.5.16vuex为2.x。如果你还没有掌握 Vue 基础官方文档的建议是先学习 Vue 官方文档再回来使用 VUX。Webpack模块打包器如果你直接使用vux2官方模板暂时可以完全不用了解 Webpack。Webpack 之所以出现在清单里是因为VUX 的按需加载能力依赖vux-loader与 Webpack loader 机制协同工作当你需要自定义构建配置如修改打包路径、调整 loader 顺序时自然就会需要了解它。仓库本身即用 Webpack 构建package.json 的dev脚本为webpack-dev-server --host 0.0.0.0 --inline --progress --config build/webpack.dev.conf.jsdevDependencies 中声明了webpack ^3.8.1与webpack-merge。也就是说vux-loader 的merge方法背后正是webpack-merge在做配置合并见 packages/loader/src/index.js 中的const merge require(webpack-merge)。vue-cli快速创建项目vue-cli是 Vue 官方用于快速创建项目的工具。官方文档给出了两种安装方式npm install vue-cli -g或者使用 yarnyarn global add vue-cli安装后用vue init拉取模板例如vux2模板即可得到一个已经配置好 Vue Webpack vue-loader 的工程。官方文档特别强调如果你直接从vux2模板起步很多底层配置尤其是 vue-loader 与 vux-loader 的配合模板已经帮你接好了可以先用起来再慢慢理解。vue-loader编译 .vue 文件的 Webpack loadervue-loader是 Webpack 的 loader用于编译.vue单文件组件template / script / style 三块。官方模板已经帮你配置好它通常你不需要手动改动。仓库自身同样以vue-loader ^14.1.1作为构建依赖见 package.json。它的工作方式值得记住.vue文件会被 vue-loader 拆解为多个selector子请求styles、script、template 三部分分别交给vue-style-loader、babel-loader、template-compiler处理。理解这一点是理解 vux-loader 存在意义的关键见下文。vux-loaderVUX 组件库的专用 Webpack loadervux-loader是 VUX 组件库配套的 Webpack loader核心作用是实现组件按需加载等工程化能力。官方文档明确了两点性质它不是替代vue-loader而是配合vue-loader使用如果你使用vux2模板暂不需要手动使用它模板已配置好。为什么要有一个前置 loader由于.vue文件的特殊性vue-loader 并不接收上一个 loader 传递的 source 直接处理而是自行生成了内部的 loader string 再进入后续处理。因此直接在 Webpack 里写vue-loader!my-loader的方式行不通。vux-loader 采用的办法是前置在 vue-loader 之前即vux-loader!vue-loader将 vue-loader 生成的代码二次处理分割 loader string 并插入 vux 自己的 template-loader / style-loader / script-loader。这套实现完整保存在仓库 packages/loader 中packages/loader/src/index.js 是入口导出merge方法负责改写原 Webpack 配置追加template-loader、script-loader、js-loader、i18n-loader等规则并注册各类插件packages/loader/src/template-loader.js、style-loader.js、script-loader.js、js-loader.js 分别对应 .vue 的模板、样式、脚本与普通 js 文件的预处理测试用例见 packages/loader/test/test.jsfixtures 覆盖了 less 主题、script 解析、style 解析、feature-switch 等场景。merge方法还做了几件重要的事检查插件是否重复同名插件只允许一个实例、根据options.env过滤仅在某环境执行的插件、检测 Webpack 1.x / 2.x 并采用不同的配置注入方式webpack 2 通过LoaderOptionsPlugin注入 vux 配置以及读取vux/src/components/map.jsonsrc/components/map.json实现组件import到单组件引入的解析。这就是 VUX 能支持import { Group, Cell } from vux这种整包引用的底层原理——vux-loader 会在编译期把它改写为按需的单组件引入。入口文件与插件示例官方文档对 vux-loader 的完整配置方式options、plugins以及script-parser、style-parser、template-parser、js-parser、template-feature-switch、vux-ui、i18n、less-theme、duplicate-style、html-build-callback、build-done-callback等插件的参数说明可进一步阅读 docs/zh-CN/vux-loader.md此处不再展开。作为使用 VUX 之前的准备阶段你只需要知道VUX 2.x 必须配合 vux-loader 使用且最小配置只需在build/webpack.base.conf.js中这样写const vuxLoader require(vux-loader) const webpackConfig originalConfig // 原来的 module.exports 代码赋值给变量 webpackConfig module.exports vuxLoader.merge(webpackConfig, { plugins: [vux-ui] })其中vux-ui插件会完成三件事配置 babel 编译 vux 的 js 源码、把 vue-loader 改写为vux-loader!vue-loader、把import组件调用解析为单组件引入。详细安装与配置见 docs/zh-CN/install/npm.md。从准备到上手安装与第一个调用了解了上述工具之后正式的上手路径就非常清晰了仓库文档给出了完整的安装与调用示例安装npm install vux --save或使用 yarnyarn add vux # 安装 yarn upgrade vux # 更新完整安装说明含从 GitHub 安装v2分支、从 0.x 升级到 2.x 等场景见 docs/zh-CN/install/npm.md从未使用过 VUX 的读者建议先参考 docs/zh-CN/install/biolerplate.md 的快速入门流程。在 .vue 文件中调用组件安装并配置好 vux-loader 之后组件的使用方式见 docs/zh-CN/install/usage.mdtemplate div group cell titletitle valuevalue/cell /group /div /template script import { Group, Cell } from vux export default { components: { Group, Cell } } /script这种import { Group, Cell } from vux的整包写法之所以可行且不会把全部组件打进包里正是前文所说的 vux-loadervux-ui插件在编译期做了import解析为单组件引入的转换。在 main.js 中调用插件VUX 的插件Alert、Toast 等则通过 Vue 插件机制在入口文件注册import { AlertPlugin, ToastPlugin } from vux Vue.use(AlertPlugin) Vue.use(ToastPlugin) // 详细使用请参考对应组件文档仓库自身的入口 src/main.js 正是这样组织插件与路由的可以作为真实项目的参考样例。常见疑问与工程化思路在准备阶段读者还常会遇到两个认知层面的问题为什么 VUX 要自己写一个 loader 而不是直接用 vue-loader 的选项因为 vue-loader 对.vue文件的处理是先拆分成子请求、生成 loader string 再继续执行直接修改其内部 loader 配置会破坏原有参数例如影响热更新。vux-loader 选择截获 vue-loader 输出并二次改写的方式既不影响 vue-loader 原有逻辑又能自由插入自定义的 template/style/script 处理。这套思路对任何需要预处理.vue文件的场景都具有参考价值。我应该先深入学 Webpack 吗不需要。官方文档的建议是用vux2模板起步时模板已经帮你配好了 vue-loader 与 vux-loader当你开始自定义配置主题、按需引入、多语言等时自然就会用到 Webpack 与 docs/zh-CN/vux-loader.md 中的各项插件到时再深入也不迟。总结开始使用 VUX 之前这份准备清单可以浓缩为三句话知识门槛会 Vue 基础了解 Node.js / npm或 yarn环境建议Node.js 7.6.0 及以上通过vue-cli从vux2模板创建项目工具认知VUX 样式源于 WeUI组件基于 Vue构建依赖 Webpack vue-loader按需加载与工程化预处理由 vux-loader 承担——使用vux2模板时这三者都无需手动配置只需要在升级为独立配置时知道vux-loader的merge方法即可。当你满足这些前提就可以进入 docs/zh-CN/install/npm.md 开始正式安装或者直接阅读 docs/zh-CN/vux-loader.md 深入了解 vux-loader 的插件体系与高级玩法了。赞分享UI组件前端【免费下载链接】vuxMobile UI Components based on Vue WeUI项目地址https://gitcode.com/gh_mirrors/vu/vux点击查看免费下载相关推荐VUX 使用前置知识指南从 Vue 与 Node 环境搭建到 vux-loader 工程化实践VUX 使用前置知识指南从 Vue 与 Node 环境搭建到 vux loader 工程化实践 本篇技术指南面向准备使用 VUX基于 Vue 与 WeUIUI组件前端vux-loader 工程化指南在 vue-loader 之前预处理 .vue 与 js 代码的 Webpack 工具vux loader 工程化指南在 vue loader 之前预处理 .vue 与 js 代码的 Webpack 工具 vux loader 是 VUX 组件UI组件前端如何在电脑上完美运行Switch游戏yuzu模拟器终极指南如何在电脑上完美运行Switch游戏yuzu模拟器终极指南 想要在电脑上体验任天堂Switch游戏的魅力吗yuzu模拟器为你打开了这扇大门作为当前最受欢迎虚拟化桌面应用图形学上一篇5步上手yuzu Switch模拟器从零编译到流畅跑游戏的完整配置指南下一篇具身智能gh_mirrors/le/leetcode机器人感知与行动一体化的终极指南创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
📝

华诺云谱内容团队

资深建站顾问 · 行业研究员

10年+企业数字化服务经验,专注智能建站、SEO优化与品牌营销,持续输出建站技巧、行业洞察与营销干货,已帮助5000+企业实现数字化增长。

你可能需要的服务

订阅华诺云谱资讯周报

每周一封,精选建站技巧、SEO与营销干货,直达邮箱。已有 8,000+ 企业主订阅,助你少走弯路。