Skip to main content

Ionic CLI

Ionic 命令行接口(CLI)是开发 Ionic 应用的首选工具。

🌐 The Ionic command-line interface (CLI) is the go-to tool for developing Ionic apps.

安装

🌐 Installation

Ionic CLI 可以使用 npm 进行全局安装:

🌐 The Ionic CLI can be installed globally with npm:

npm install -g @ionic/cli

帮助

🌐 Help

Ionic CLI 附带有命令文档,可通过 --help 标志访问。

🌐 The Ionic CLI ships with command documentation that is accessible with the --help flag.

$ ionic --help
$ ionic <command> --help
$ ionic <command> <subcommand> --help
note

确保在你的项目目录中运行 ionic <command> --help

对于某些命令,例如 ionic serve,帮助文档是根据你的项目类型而定的,例如 React 与 Angular。

🌐 For some commands, such as ionic serve, the help documentation is contextual to the type of your project, e.g. React vs Angular.

架构

🌐 Architecture

Ionic CLI 是用 TypeScriptNode.js 构建的。它支持 Node 10.3 及以上版本,但总是推荐使用最新的 Node LTS。可以在开源的 GitHub 仓库上关注开发进展。

故障排除

🌐 Troubleshooting

要解决 Ionic CLI 的问题,以下内容可能有用:

🌐 To troubleshoot issues with the Ionic CLI, the following may be useful:

  • 确保已安装最新版本的 Ionic CLI。通过运行 ionic --version 获取已安装的 Ionic CLI 版本。Ionic CLI 版本与 Ionic Framework 版本无关。
  • 确保已安装最新的 Node LTS。请参见 Node & npm 环境设置。
  • --verbose 标志会打印调试信息,这可能有助于缩小问题范围。
  • 连接问题可能是由于代理设置配置不当引起的。请参阅 使用代理 以配置请求代理。
  • 全局 Ionic CLI 配置目录在所有平台上都是 ~/.ionic。它可以安全删除,Ionic CLI 会重新生成它,但所有配置(包括用户会话)将会丢失。可以通过 CLI 环境变量 配置此目录。