Vue CLI 安装与项目创建,顺便记一下可能会碰到的环境问题

不管用什么方式,都得先把 Node.js 环境装好。去官网下 LTS 版本,安装的时候那个 Add to PATH 记得勾上,免得后面自己手配环境变量。装完打开终端验证一下:

node -v
npm -v

只要这两条都能正常输出版本号就没问题。Node 版本这块,Vue CLI 5 要求 Node 12 以上,但跟着 LTS 走肯定是最省心的,不太可能踩坑。

国内网络环境你懂的,不换源的话 npm install 能卡到人没脾气。现在淘宝镜像域名已经更新成 npmmirror.com 了,别用老的那个了,直接设一下:

npm config set registry https://registry.npmmirror.com/

顺手可以跑一句 npm config get registry 确认是不是已经指向新地址了。

Windows 下经常会碰到权限问题,提前把 npm 的缓存和全局安装目录改到用户目录下面,后面能少很多麻烦。不是必须步骤,但做了不亏:

mkdir C:\Program Files\nodejs\cache
mkdir C:\Program Files\nodejs\global
npm config set cache "C:\Program Files\nodejs\cache"
npm config set prefix "C:\Program Files\nodejs\global"

这些路径你自己看着改就行,放其他盘也行,只要能写入。

装 CLI 本身倒没什么花头。管理员身份开终端,不然全局安装大概率写不进去:

npm install -g @vue/cli --no-fund

-g 表示全局安装,装完以后在任意目录都能用 vue 命令。

--no-fund 纯粹是为了让终端输出干净一点,省得每次 npm 都跑来告诉你“我们接受捐赠”。

装完看看版本,确认安装成功:

vue -V

输出应该类似 @vue/cli 5.x.x。如果提示命令找不到,检查一下环境变量,或者把终端关掉重新打开,让 Path 刷新一下。

到想建项目的目录下,执行:

vue create my-project

然后它会弹出来一系列选项。懒得折腾就直接选 Default,默认给 Babel + ESLint。如果想自己组合东西,选 Manually select features,然后按空格勾选需要的特性——Vue 版本、Router、Vuex、CSS 预处理器这些都可以在这个环节挑好。后面几步就是一些配置细节了,按自己习惯选就行,一般也不用太纠结。

项目创建完,切进去把开发服务器跑起来:

cd my-project
npm run serve

编译结束以后终端会告诉你地址,通常是 http://localhost:8080,浏览器打开看到 Vue 的欢迎页面就说明一切顺利。

端口如果被占了它会自动换一个,不用慌。

最后说两个高频问题。Windows 上如果报 EACCES 权限错误,要么用管理员身份重新跑一下终端,要么就把 npm 的 prefix 强行改到当前用户的 AppData 目录下:

npm config set prefix "C:\Users\用户名\AppData\Roaming\npm"

路径里把“用户名”换成你自己的。

业务涉及海外或中文域名,lcjmSSL完美支持国际化域名 (IDN) 及纯中文域名的SSL证书申请。无论的域名是英文域名还是中文.网址,都能在的平台顺利通过验证并获得加密保护。

以后要升级 Vue CLI 的话,一条命令就行:

npm update -g @vue/cli

顺手就能把全局包升到最新,不用重新走一遍安装流程。

posted @ 2026-06-27 19:56  枫唐  阅读(15)  评论(0)    收藏  举报