安装
本页面将指导您完成 uniapp 开发工具的安装过程。
选择安装方式
uniapp 开发工具提供两种安装方式:
- utools 插件 - 适合 utools 用户,安装快捷,自动更新
- 独立安装包 - 适合所有用户,无需额外依赖
请根据您的需求选择合适的安装方式。
方式一:utools 插件安装
前置要求
- 已安装 utools 应用
快速安装
推荐方式:直接从插件市场安装
👉 点击这里直接安装
点击上方链接将打开 utools 插件详情页,点击"安装"即可。
手动安装步骤
打开 utools
使用快捷键打开 utools:
- Windows/Linux:
Alt + Space - macOS:
Option + Space
- Windows/Linux:
搜索插件
在 utools 搜索框中输入:
uniapp应用开发工具安装插件
- 在搜索结果中找到"uniapp应用开发工具"插件
- 点击插件卡片
- 点击"安装"按钮
- 等待安装完成
启动工具
安装完成后,在 utools 中输入关键词即可启动:
uniapp
更新插件
utools 插件会自动检查更新。您也可以手动更新:
- 在 utools 中输入
插件管理 - 找到"uniapp 开发工具"
- 如果有新版本,点击"更新"
方式二:独立安装包安装
下载安装包
前往下载页面选择适合您系统的安装包:
- Windows:
uniapp-tools-windows-x64.exe - Mac Intel:
uniapp-tools-mac-intel.dmg - Mac ARM:
uniapp-tools-mac-arm.dmg
Windows 安装
下载安装包
下载
uniapp-tools-windows-x64.exe文件运行安装程序
双击下载的
.exe文件启动安装向导安装选项
- 选择安装路径(推荐使用默认路径)
- 选择是否创建桌面快捷方式
- 点击"安装"
完成安装
- 等待安装完成
- 勾选"运行 uniapp 开发工具"
- 点击"完成"
Mac 安装
下载安装包
根据您的 Mac 芯片类型下载对应的
.dmg文件:- Intel 芯片:
uniapp-tools-mac-intel.dmg - Apple Silicon (M1/M2/M3):
uniapp-tools-mac-arm.dmg
- Intel 芯片:
打开 DMG 文件
双击下载的
.dmg文件安装应用
- 将"uniapp 开发工具"图标拖拽到"Applications"文件夹
- 等待复制完成
首次运行
从启动台或应用程序文件夹打开应用
macOS 安全提示
如果遇到"无法打开,因为来自身份不明的开发者"的提示:
方法一:
- 打开"系统偏好设置" > "安全性与隐私"
- 在"通用"标签页中,点击"仍要打开"按钮
方法二:
- 右键点击应用图标
- 选择"打开"
- 在弹出的对话框中点击"打开"
验证安装
安装完成后,验证工具是否正确安装:
检查版本
打开应用后,在主界面或关于页面查看版本信息:
- 版本号应显示为
v1.0.0或更高 - 确认平台信息正确(Windows/Mac Intel/Mac ARM)
基本功能测试
- 检查是否能正常打开应用界面
- 检查菜单栏和工具栏是否正常显示
- 尝试打开帮助文档
系统要求
Windows
- 操作系统: Windows 10 (64-bit) 或更高版本
- 内存: 至少 4GB RAM
- 磁盘空间: 至少 500MB 可用空间
- 其他: .NET Framework 4.7.2 或更高版本
macOS
- 操作系统:
- Intel: macOS 10.15 (Catalina) 或更高版本
- Apple Silicon: macOS 11.0 (Big Sur) 或更高版本
- 内存: 至少 4GB RAM
- 磁盘空间: 至少 500MB 可用空间
常见问题
Windows 安装失败
问题: 提示"无法安装"或"安装程序错误"
解决方案:
- 确认系统是 64 位 Windows 10 或更高版本
- 检查是否有足够的磁盘空间
- 尝试以管理员身份运行安装程序
- 关闭杀毒软件后重试
Mac 无法打开应用
问题: 提示"应用已损坏"或"无法验证开发者"
解决方案:
- 打开终端,运行以下命令:bash
sudo xattr -r -d com.apple.quarantine /Applications/uniapp开发工具.app - 输入管理员密码
- 重新打开应用
安装后找不到应用
Windows:
- 检查开始菜单中的程序列表
- 检查桌面是否有快捷方式
- 查看默认安装路径:
C:\Program Files\uniapp开发工具\
macOS:
- 从启动台查找
- 打开访达,前往"应用程序"文件夹
- 使用 Spotlight 搜索(
Cmd + Space)
卸载
Windows 卸载
- 打开"设置" > "应用" > "应用和功能"
- 找到"uniapp 开发工具"
- 点击"卸载"
- 按照提示完成卸载
macOS 卸载
- 打开访达,前往"应用程序"文件夹
- 找到"uniapp 开发工具"
- 拖拽到废纸篓,或右键选择"移到废纸篓"
- 清空废纸篓
下一步
安装完成后,您可以:
如果遇到问题,请访问 GitHub Issues 寻求帮助。
