如何创建一个vue项目-优先选用npm标准脚手架指令搭建
上周赶小组作业,被逼着从零实操如何创建一个vue项目,全程桌面终端来回敲命令,踩了一堆新手都会犯的随性错误,没有套用网上花里胡哨的快捷脚本,只用原生终端指令做完了整套搭建。
最开始图省事,直接双击打开桌面下载好的vue压缩包解压运行,这是第一个白做工的错误。以为跳过脚手架,直接启用本地文件就能启动项目,解压完成后点开index.html,页面直接空白,控制台铺满依赖缺失报错,弹窗提示缺少vue核心运行模块,折腾四十分钟修补文件,依旧没法正常热更新,页面改动一次就要手动刷新浏览器。
随便选了一个本地文件夹,右键打开cmd终端,没有提前检查node版本,直接敲创建命令。这步是绝大多数新手隐形翻车点,电脑留存的旧node版本是12.14,版本过低,输入官方创建指令后,终端直接报错终止,弹窗提示引擎版本不兼容,根本没法初始化项目文件夹。
后来才反应过来,搭建前必须核验运行环境,输入node -v、npm -v两行短句就行,当下直接卸载旧版本,重装了18.17稳定版node,配套自带合规npm版本,适配vue3全部新项目,不用额外适配兼容补丁。
直接使用官方推荐基础指令搭建项目。打开空白英文命名文件夹,切记文件夹不能带中文、空格、特殊符号,不然后续打包百分百报错。终端输入npm create vue@latest,回车后终端弹出交互式选项菜单,全程只做基础勾选:项目自定义名称、默认vue3版本、添加router路由、添加pinia状态管理,其余ts、单元测试、eslint格式化全部取消勾选,新手没必要叠加冗余配置。
回车等待一分半,依赖自动初始化完毕,终端会给出两行收尾指令。先cd 项目文件名进入项目根目录,再输入npm install补齐本地依赖,很多人卡在这一步,直接跳过install就启动项目,本地依赖残缺,开发工具打开代码会爆红。
最后输入npm run dev,终端生成本地访问地址,复制到浏览器,vue默认首页加载成功,项目就彻底创建完成。
中途试过用yarn替代npm下载依赖,下载速度看着更快,但公司后端电脑适配性很差,依赖下载一半无故中断,反复重试五次都失败,索性放弃包管理器切换,全程只用npm,适配所有办公家用电脑,稳定性更省心。
还有一个无关紧要的小毛病,创建时随手给项目取了中文名,初始化虽然成功,后续移入vscode编辑,文件路径乱码,每次保存代码都会卡顿两秒,只能删掉重建英文名称新项目。
关掉终端的时候,桌面还留着最开始解压失败的vue压缩包,没删,就放在文件夹角落堆着。