
Arco Design Pro 使用常见报错及解决方法
在执行 arco init <项目名称>
命令时遇到错误:
1. TypeError: Cannot read properties of undefined (reading ‘question’)
这是 arco-cli
工具在初始化项目时的一个已知问题。该错误通常是由于未正确加载 CLI 的基础配置,导致无法读取相关的 question
属性。
我尝试成功的一个解决方法如下:
- 进入你需要创建项目的目录后,使用命令npm create(这是一个基于 npm init 的快捷脚手架工具):
npm create arco-pro@latest
- 接着会提示让你输入项目名称,并针对需求选择项目属性之后即会显示项目初始化成功:
PS:还看到一个解决方式是使用一下命令进行初始化项目,但是没有尝试,不知道是否有用,具体命令如下:
cross-env BASE_CONFIG=local arco init <项目名称>
2. ‘vite’ 不是内部或外部命令,也不是可运行的程序或批处理文件
这里只需要单独装一下vite库就行,但是注意版本兼容性,比如我装了最新的vite以后出现了与其他库不兼容的现象:
装指定vite库版本的安装命令为(这里指定为3.x版本):
npm install vite@3 --save-dev
但是由于这里我会报错误 ECONNRESET
,所以这里我更换包管理工具yarn即可成功安装:
- 先装yarn库:
npm install -g yarn
- 再利用yarn来装vite:
yarn add vite@3 --dev
这样安装即成功,猜测原因应该是主要因为 yarn
的并行安装、严格版本锁定和更好的缓存机制,能更稳定地处理 Vite 的依赖关系,而 npm
可能因网络、缓存或依赖冲突导致安装失败。
- 此时能够正常运行代码,并自动打开相应的网页:
PS:这是第一次尝试使用Arco Design,可能解决报错略有不成熟