meteor-cli-installation

安装和修复 Meteor CLI

在不更改应用或删除用户未指定的状态的前提下，提供 Meteor CLI。npx meteor 会运行官方 npm 安装程序，并创建用户级 Meteor 安装；它不会将安装程序永久添加到全局 npm 软件包中。

决策流程

1. 在更改机器之前，对请求进行分类。
   • 当用户要求设置 Meteor，或请求需要使用 Meteor 的本地创建、运行、测试、构建或部署操作时，安装缺失的 CLI。
   • 如果用户仅要求解释、审查或规划，则指出缺少的先决条件和安装命令，但不要运行命令。
   • 在执行任何会删除状态的恢复操作之前，必须先获得用户的明确确认：meteor reset、meteor reset --db、清除 npm 缓存、定向清理全局元数据、卸载或完整重新安装。
   • 如果现有证据表明清理或重新安装可能有帮助，则建议破坏性最小的选项，并说明理由、范围和预计丢失的状态。用户明确确认该操作前，不要执行。
2. 检查主机和目标项目。检查操作系统、架构、node --version、npm --version、CLI 查找结果，以及可用时的 meteor --version。在应用中，选择发行版之前先读取 .meteor/release。
3. 区分用户请求的版本：
   • npx meteor@<version> 中的 npm 选择器用于选择安装程序软件包。
   • Meteor 应用在 .meteor/release 中固定了框架发行版。 不要仅仅因为项目使用了另一个发行版，就重新安装用户级 CLI。 对于现有本地数据，在选择 Meteor 3.6-beta.3 或 3.6-rc.0 之前，请阅读本地数据库准备。 其中捆绑的 MongoDB 8 要求检查主机，并在新发行版启动前，通过先前发行版准备 MongoDB 7 FCV。
4. 对于 CLI 缺失、PATH 故障、npm 安装程序故障或主机先决条件问题，请遵循安装和 PATH。
5. 对于项目发行版、缓存重置、开发捆绑包损坏、卸载或干净重新安装，请遵循发行版、重置和重新安装。 在根据已观察到的故障建议进行用户级重新安装之前，请先使用重新安装决策指南。
6. 使用 meteor --version 验证结果。对于项目操作，运行范围最窄的所请求 Meteor 命令，并确认其解析的是 .meteor/release 中的发行版。报告运行的命令、所选版本、删除的状态，以及用户需要在新 shell 中执行的操作。

安装规则

情况	操作
最新受支持的 CLI	运行 npx meteor。
固定的安装程序软件包	运行 npx meteor@<version> install，然后验证报告的 Meteor 发行版。
Linux 或 macOS 替代方案	仍有文档记录 curl https://install.meteor.com/ | sh。将 npx meteor 作为首选的跨平台命令。
npm 备用方案	仅当文档所述的 npx 恢复步骤失败后，才运行 npm install -g meteor --foreground-script。
现有项目需要另一个发行版	使用项目的固定版本，或使用 Meteor --release 命令。不要先替换用户级安装。

绝不要运行 npx install meteor。绝不要将 npm meteor 安装程序添加到应用的 package.json 中；它是安装程序，不是框架运行时。

状态边界

状态	范围	安全操作
用户的 Meteor 目录	用户的下载工具、发行版、开发包和 CLI 状态	npx meteor uninstall 会移除整个安装。仅在获准卸载或全新重装时使用。
用户的包目录元数据	用户 Meteor 目录中的共享发行版和包元数据	优先执行常规的在线目录刷新。将针对性重建元数据视为高级恢复操作，必须先确认。
.meteor/release	项目框架发行版	通过 meteor update --release <release> 更改，而非全局重装。
.meteor/local	项目构建缓存、生成的状态和本地开发数据库	如有项目缓存问题的证据，可建议运行 meteor reset；此命令会保留数据库。meteor reset --db 会将其删除。运行任一命令前都必须先确认。
npm npx 缓存	临时安装程序包缓存	仅在发生特定于 npx 的故障后建议清理，不用于解决普通的 Meteor 构建问题。运行前必须先确认。

不要在没有文档所述命令、且没有证据能确认目标层级的情况下，选择性删除内部工具或开发包目录。项目缓存损坏时使用 meteor reset。仅当用户级安装本身损坏时，才进行完整且获准的重装。切勿向用户推荐隐藏的 Meteor 管理命令来清理缓存。

移交

• CLI 已启动，但应用失败：meteor-debugging。
• 应用必须从 Meteor 2 迁移到 Meteor 3：migrate-to-meteor-3。
• CLI 和项目状态分类后，构建缓存或打包器故障仍未解决：meteor-modern-build-stack 或 migrate-to-rspack。
• 部署凭据、Galaxy、容器或运行时配置：meteor-deployment。

参考资料

• 安装和 PATH
• 发行版、重置和重装
• 重装决策指南
• 评估案例