SuperAPI AI 工具集

meteor-cli-installation

部署与运维

查看项目

更新于 10-16 06:46

技能介绍

用途:在安装、定位、修复、重置或卸载 Meteor 3 开发所需的 Meteor CLI 时使用,触发场景包括 "meteor: command not found"、npx 安装器失败等。目标是在不改动应用、不删除用户未授权状态的前提下让 CLI 可用。

主要能力与决策:先分类请求再改动机器。用户要求配置 Meteor,或需要本地 create、run、test、build、deploy 时才安装缺失的 CLI;仅解释、审查或规划时,只报告缺失前置条件和安装命令,不执行。任何会移除状态的操作(meteor reset、meteor reset --db、清 npm 缓存、定向清理全局元数据、卸载、完全重装)都需用户显式确认,且应先建议破坏性最小的方案并说明理由、范围与预期损失。

检查与版本:查看操作系统、架构、node --version、npm --version、CLI 查询结果,可用时查 meteor --version;在应用内先读 .meteor/release。npx meteor@<version> 的版本选择器选的是安装器包;应用版本由 .meteor/release 固定,不要因项目用另一发行版就重装用户级 CLI。对已有本地数据选用 Meteor 3.6-beta.3 或 3.6-rc.0 前,需阅读本地数据库准备说明,其内置 MongoDB 8 要求主机检查并在旧发行版下准备 MongoDB 7 FCV。

安装规则:最新受支持 CLI 运行 npx meteor;固定安装器包运行 npx meteor@<version> install,再核对报告的 Meteor 发行版;Linux/macOS 仍记录 curl https://install.meteor.com/ | sh,但以 npx meteor 为主;仅在文档化 npx 恢复步骤失败后才用 npm install -g meteor --foreground-script。项目需要另一发行版时用项目固定或 Meteor --release 命令,不先替换用户级安装。永远不要运行 npx install meteor,也不要把 npm meteor 安装器加进应用 package.json,它是安装器不是框架运行时。

状态边界与验证:用户 Meteor 目录由 npx meteor uninstall 整体移除,仅用于已授权卸载或干净重装;.meteor/release 用 meteor update --release <release> 修改;.meteor/local 是项目构建缓存与本地开发数据库,meteor reset 保留数据库,meteor reset --db 会删除;npm npx 缓存仅在 npx 专属失败后建议清理。不要选择性删除内部工具或 dev-bundle 目录。用 meteor --version 验证,项目工作运行最窄的请求命令并确认其解析 .meteor/release 中的发行版,报告所运行命令、所选版本、移除的状态及用户需在新 shell 中做的事。交接:CLI 启动但应用失败交给 meteor-debugging;Meteor 2 迁 3 交给 migrate-to-meteor-3;构建缓存或打包器问题交给 meteor-modern-build-stack 或 migrate-to-rspack;部署交给 meteor-deployment。