文档

外观

安装 ​

您需要安装 Meteor 命令行工具才能创建、运行和管理您的 Meteor.js 项目。请检查先决条件并按照以下安装过程操作。

bash
npx meteor

先决条件 ​

操作系统 (OS) ​

  • Meteor 目前支持 **OS X、Windows 和 Linux**。仅支持 64 位。
  • Meteor 支持 Windows 7/Windows Server 2008 R2 及更高版本。
  • 从 Meteor 2.5.1 开始原生支持 Apple M1（对于旧版本，需要 Rosetta 终端）。
  • 如果您使用的是 Mac M1（Arm64 版本），则需要安装 Rosetta 2，因为 Meteor 使用它来运行 MongoDB。请查看 此处 如何安装。
  • 禁用防病毒软件（Windows Defender 等）将提高性能。
  • 为了兼容性，Linux 二进制文件使用 CentOS 6.4 i386/amd64 构建。

移动开发 ​

  • iOS 开发需要最新的 Xcode。

安装 ​

通过运行以下命令之一，从您的终端安装最新版本的 Meteor.js。您可以查看我们的 更改日志 以获取发行说明。

对于 Windows、Linux 和 OS X，您可以运行以下命令

bash
npx meteor

提示

如果安装 npx 时出现错误，您可以尝试运行 npx clear-npx-cache

或 rm -rf ~/.npm/_npx

如果错误仍然存在，请尝试使用 npm 安装 Meteor

bash
npm install -g meteor --foreground-script

确保已安装 Node.js v20 或更高版本。

对于 Linux 和 OS X，另一种方法是使用 curl 安装 Meteor

bash
curl https://install.meteor.com/ | sh

您还可以使用 curl 安装特定版本的 Meteor.js

bash
curl https://install.meteor.com/\?release\=2.8 | sh

不要在项目的 package.json 中安装 npm Meteor 工具。此库只是一个安装程序。

故障排除 ​

如果您的用户没有权限安装全局二进制文件，并且您需要使用 sudo，则需要将 --unsafe-perm 附加到上述命令

bash
sudo npm install -g meteor --unsafe-perm

我们强烈建议不要使用 root 权限运行 Node.js 或 Meteor。仅当您知道自己在做什么时才使用 sudo 运行上述命令。

如果您仅因发行版默认权限系统而使用 sudo，请查看此链接以解决此问题。

在某些情况下，您可能会收到此错误 npm WARN checkPermissions Missing write access to /usr/local/lib/node_modules，因为您的 Node.js 安装使用错误的权限执行。解决此问题的简单方法是使用 nvm 安装 Node.js 并强制在您的终端中使用它。您可以通过运行 nvm use 14 强制在终端的当前会话中使用它。

PATH 管理 ​

默认情况下，Meteor 安装程序会将其安装路径（默认为 ~/.meteor/）添加到您的 PATH 中，方法是根据需要更新 .bashrc、.bash_profile 或 .zshrc。要禁用此行为，请通过运行以下命令安装 Meteor

bash
npm install -g meteor --ignore-meteor-setup-exec-path --foreground-script

（或设置环境变量 npm_config_ignore_meteor_setup_exec_path=true）

Apple M1 上的旧版本 ​

对于 Apple M1 计算机，如果您需要运行旧版本的 Meteor（2.5.1 之前的版本），您可以按如下方式附加 Rosetta 前缀：

bash
arch -x86_64 npm install -g meteor

或在应用程序文件夹中选择终端，按 CMD(⌘)+I 并选中“使用 Rosetta 打开”选项。

Meteor Docker 镜像 ​

您还可以使用 Docker 容器在您的 CI 中甚至在您的本地开发工具链中运行 Meteor。

我们提供了基于 ubuntu 的 meteor/meteor-base Docker 镜像，其中预捆绑了 Node.JS 和 Meteor，并将其作为本地用户（而不是 root 用户）运行。

您可以参考我们的 meteor/galaxy-images 存储库以了解如何使用它以及最新版本。此处详细了解 meteor-base。

Windows 用户注意事项 ​

在 Windows 上，当 启用 Windows 开发人员模式 时，安装程序运行速度更快。安装会提取大量的小文件，Windows Defender 可能会导致这些文件提取速度非常慢。

节点版本管理器 ​

如果您使用的是节点版本管理器，该管理器为每个 Node 版本使用单独的全局 node_modules 文件夹，则在首次切换到 Node 版本时，您需要重新安装 meteor npm 包。否则，将找不到 meteor 命令。

fish shell 用户注意事项 (Linux) ​

为了能够从 fish 使用 meteor 命令，需要在 $PATH 中包含 /home/<user>/.meteor；为此，只需在 /home/<user>/.config/fish/config.fish 文件中添加此行（将 <user> 替换为您的用户名）

set PATH /home/<user>/.meteor $PATH

卸载 Meteor ​

如果您使用 npx 安装了 Meteor，则可以通过运行以下命令将其删除

bash
npx meteor uninstall

如果您使用 curl 或作为备用解决方案安装了 Meteor，请运行

rm -rf ~/.meteorsudo rm /usr/local/bin/meteor