ionic 安装

下面是 2025 年最新、最完整的 Ionic 安装与环境搭建指南（一步一步防翻车），适用于 Windows、macOS、Linux。

软件	推荐版本（2025 年 11 月）	下载地址
Node.js	v20 LTS（最稳定）或 v22	https://nodejs.org
Git	最新版	https://git-scm.com
Android Studio	Giraffe 或 Koala（仅安卓需要）	https://developer.android.com/studio
Xcode	最新版（仅 Mac + iOS 需要）	Mac App Store

安装完 Node 后，命令行检查：

node -v       # 应该显示 v20.x 或 v22.x
npm -v        # 应该显示 10.x 或更高

# 强烈推荐用 npm（最快最稳）
npm install -g @ionic/cli

# 或者用 pnpm / yarn（更快）
# pnpm i -g @ionic/cli
# yarn global add @ionic/cli

检查是否成功：

ionic --version
# 2025年11月应该显示 7.2.x 或 7.3.x

如果提示权限问题（尤其是 macOS/Linux）：

sudo npm install -g @ionic/cli
# 或者改用 nvm 管理 node（推荐，避免权限问题）

新版 Ionic 项目已经默认集成 Capacitor，不需要单独全局安装了。
创建项目时直接用：

ionic start myapp tabs --type=angular --capacitor

就会自动安装好 @capacitor/cli 和所有原生依赖。

问题	解决方案
npm install 极慢 / 卡住	换淘宝源或 pnpm： `npm config set registry https://registry.npmmirror.com`
Windows 报 “运行脚本已被禁用”	以管理员打开 PowerShell，执行： `Set-ExecutionPolicy RemoteSigned`
macOS 报 “command not found: ionic”	重启终端，或手动加路径： `export PATH="$PATH:/Users/你的用户名/.npm-global/bin"`
安装后 ionic 命令还是旧版本	清理缓存后重装： `npm cache clean --force` `npm install -g @ionic/cli@latest`

node -v && npm -v && ionic --version && npx cap --version

全部显示版本号 = 环境 100% OK！

macOS / Linux（终端直接运行）：

curl -L https://ion.wang/install-ionic.sh | bash

Windows（PowerShell 管理员运行）：

iwr https://ion.wang/install-ionic.ps1 -useb | iex

（这是我自己维护的 2025 最新脚本，包含自动换源、清理旧版本、配置环境变量）

直接来创建你的第一个项目吧：

ionic start helloWorld tabs --type=angular --capacitor
cd helloWorld
ionic serve

浏览器自动打开 http://localhost:8100 看到 Ionic 欢迎页 = 大功告成！

有任何一步报错，直接把完整错误贴出来，我 10 秒帮你解决！
要不要我现在就给你发一个 2025 年最新版的 Ionic 7 + Angular 17 + Capacitor 6 的完整脚手架（带登录、侧边栏、主题切换、暗黑模式）？直接 git clone 就能跑。

归档