Meteor 快速上手指南安装、创建与运行你的第一个 JavaScript 全栈应用【免费下载链接】meteorMeteor, the JavaScript App Platform项目地址: https://gitcode.com/gh_mirrors/me/meteorMeteor 是一个面向现代 Web 应用构建的 JavaScript 应用平台App Platform本指南基于当前仓库根目录 README.md 的 Quick Start 内容展开涵盖从环境准备、安装、创建项目到启动开发服务器、卸载的完整流程。读完本文你将掌握meteor create、meteor即meteor run等核心命令的实战用法并理解其底层工具链与安装机制能够独立搭建并运行第一个 Meteor 应用。Meteor 是什么三个核心特性按照仓库根 README.md 的定义Meteor 是一个用于构建现代 Web 应用的超简单环境ultra-simple environment用它可以写出具备以下特点的应用使用现代 JavaScript 编写全栈统一使用 JavaScript/ECMAScript无需割裂前后端语言通过网络传输数据而非 HTMLMeteor 采用数据Data over the wire优先的架构客户端与服务器之间通过 DDP 协议同步数据而不是传统的请求-渲染 HTML 页面模式使用你喜欢的流行开源库React、Vue、Svelte、Blaze、Angular 等前端框架都可以作为视图层接入同时完整支持 npm 生态。Meteor 官方为每种主流前端框架都提供了入门教程React、Blaze、Angular、Vue、Svelte初次接触时建议先跟着对应框架的教程完成一个示例项目再回到本文阅读命令细节。环境准备Node.js 版本与操作系统要求安装 Meteor 之前请先确认你的环境满足要求。仓库中的 安装文档 给出了明确说明Node.js 版本Meteor 2.x 运行在已弃用的 Node.js 14 上Meteor 3 已发布并支持最新的 Node.js LTS 版本。安装器文档 meteor-installer/README.md 中明确给出推荐组合Meteor 2Legacy使用 Node.js 14.x、npm 6.xMeteor 3使用 Node.js 20.x 或更高、npm 9.x 或更高。推荐使用 nvm 或 Volta 这类版本管理器来管理 Node.js 版本。操作系统目前支持 OS XmacOS、Windows 和 Linux仅支持 64 位Apple M1arm64从 Meteor 2.5.1 起原生支持更早版本需要 Rosetta 终端Linux 二进制基于 CentOS 6.4 i386/amd64 构建以保证兼容性。移动开发iOS 开发需要最新版 Xcode。注意meteor这个 npm 包只是安装器不是 Meteor 框架本身。不要把它写进项目的package.json依赖里否则可能破坏你的部署。安装 Meteor三种方式对比方式一npm 全局安装推荐全平台通用在 Windows、Linux、macOS 上使用一行命令即可npm install -g meteor此命令会把meteor安装为全局 npm 包。安装器见 meteor-installer默认会把安装路径默认为~/.meteor/写入 PATH——它会自动更新你的.bashrc、.bash_profile或.zshrc中合适的一个。如果不想修改 shell 配置文件可以这样安装npm install -g meteor --ignore-meteor-setup-exec-path或者通过环境变量npm_config_ignore_meteor_setup_exec_pathtrue达到同样效果。代理配置如果网络需要代理设置https_proxy或HTTPS_PROXY环境变量为有效的代理 URL即可通过代理下载 Meteor 文件。方式二curl 管道安装macOS / Linuxcurl https://install.meteor.com/ | sh如果想安装指定版本可以传release参数curl https://install.meteor.com/\?release\2.8 | sh方式三npx 免安装运行临时执行安装器仓库中的 meteor-installer/README.md 还提供了一种不污染全局 npm 包的方式——安装最新版npx meteor安装指定版本npx meteorversionnpx meteor会执行 Meteor 安装器而不会把它永久加入全局 npm 包。安装后的版本兼容性安装器包版本与 Meteor 官方发布版本一一对应例如 npm 包3.0.4对应 Meteor 官方发布3.0.4、2.16.0对应2.16.0完整对照表见 npm-packages/meteor-installer/README.md。安装排错Troubleshooting安装文档 docs/source/install.md 给出了常见问题的处理建议如果全局安装没有权限、必须使用sudo请附加--unsafe-perm参数sudo npm install -g meteor --unsafe-perm官方强烈不建议以 root 权限运行 Node.js 或 Meteor除非你明确知道自己在做什么。若出现npm WARN checkPermissions Missing write access to /usr/local/lib/node_modules通常是 Node.js 安装时权限配置错误所致推荐改用 nvm 安装 Node.js并在当前终端执行nvm use 14Meteor 2来修复。作为最后手段可以删除主目录下的.meteor文件夹后以正确权限重新安装。使用按 Node 版本隔离全局node_modules的版本管理器时切换 Node 版本后需要重新安装一次meteornpm 包否则meteor命令会找不到。fish shell 用户Linux需要在/home/user/.config/fish/config.fish中添加一行set PATH /home/user/.meteor $PATH。Windows 用户开启开发者模式可显著加快安装安装器会解压大量小文件Windows Defender 实时扫描会导致安装变慢。Apple M1 上运行 2.5.1 之前的老版本 Meteor可使用arch -x86_64 npm install -g meteor加 Rosetta 前缀。创建你的第一个 Meteor 项目基础用法安装完成后创建项目只需一条命令meteor create try-meteor该命令会在当前目录下创建try-meteor子目录如果不存在并生成一个全新的 Meteor 应用。meteor create接受的路径可以是绝对路径、相对路径也可以是.表示当前目录。从 CLI 帮助文件 tools/cli/help.txt 可以看到meteor create的完整用法还支持--release指定 Meteor 版本以及多种脚手架skeleton选项。命令实现位于 tools/cli/commands.js其中定义了可用脚手架列表、默认脚手架DEFAULT_SKELETON即 React以及交互式选择逻辑——当你不指定脚手架选项时工具会直接使用默认的 React 脚手架。选择应用脚手架Skeletonmeteor create支持多种脚手架满足不同技术栈需求选项说明--bare创建空应用--minimal创建包含最少 Meteor 包的空应用--full创建完整脚手架的应用--react创建基于 React 的基础应用与默认相同--vue创建基于 Vue 3 的基础应用--apollo创建基于 Apollo 的基础应用--svelte创建基于 Svelte 的基础应用--typescript创建基于 TypeScript React 的基础应用--blaze创建基于 Blaze 的基础应用--tailwind创建配置了 Tailwind 的 React 基础应用--chakra-ui创建配置了 Chakra UI 的 React 基础应用--coffeescript创建 CoffeeScript React 基础应用--babel创建带 Babel 支持的 React 应用--solid创建基于 Solid 的基础应用--angular创建基于 Angular 的基础应用--prototype创建包含 insecure 与 autopublish 包的原型应用例如创建一个 Vue 3 项目meteor create --vue my-vue-app从社区示例或 Git 仓库创建--example slug以某个 Meteor 社区示例为起点复制项目用--list可查看可用示例列表--from url从 Git URL 克隆一个 Meteor 项目支持 GitHub、GitLab、Bitbucket 的 tree/src 类型 URL分支和子目录可从 URL 自动解析也可用--from-branch、--from-dir覆盖。从源码结构看见 tools/cli/examples.js示例列表来自远程examples.json分支为main工具会优先联网获取并写入本地缓存离线时自动回退到缓存克隆完成后会移除.git目录使其成为普通项目目录。创建 Meteor 包meteor create --package [package_name]可以创建一个 Meteor 包而非应用。在应用内执行时包会创建到应用顶层的packages目录否则创建到当前目录。包会使用当前应用对应的 Meteor 版本。运行项目meteor与meteor run启动开发服务器进入项目目录并启动cd try-meteor meteor不带参数运行meteor时等价于meteor run即以本地开发模式运行当前项目。CLI 帮助tools/cli/help.txt中说明它会从当前目录向上查找 Meteor 项目根目录即包含.meteor目录的目录可以在项目根目录或任意子目录运行。启动后浏览器访问localhost:3000即可看到应用本地开发模式不需要联网修改任意应用源文件后变更会被自动检测并热应用到正在运行的应用应用数据库会持久保存在项目根目录的.meteor目录下跨多次运行不丢失。meteor run的常用选项从 tools/cli/help.txt 可以查到meteor run支持的关键选项选项说明--port, -p指定监听端口默认 3000会同时占用 N1 端口支持--porthost:port形式绑定特定网卡--open, -o应用启动时自动打开浏览器窗口--inspect[-brk][port]开启服务端调试Node.js 调试器、Chrome DevTools、VS Code 均可连接--inspect-brk会在服务启动时暂停等待调试客户端连接默认端口 9229--settings, -s指定设置文件作为服务端Meteor.settings的数据来源--production模拟生产模式压缩并打包 CSS/JS--release指定使用的 Meteor 版本--no-lint每次重建时不运行 linter--mobile-server指定移动端构建连接 Meteor 服务器的地址--exclude-archs不为某些 Web 架构生成包如web.browser.legacy, web.cordova例如换个端口启动并自动打开浏览器meteor run --port 4000 --open关于meteor node与meteor npmMeteor 内置了它自己使用的 Node.js 与 npm。执行meteor node或meteor npm时运行的正是 Meteor 内部使用的同版本 node/npm。也可以像meteor npm install --global package name这样为其他命令如 yarn、jsdoc安装全局工具之后用meteor other command调用。注意升级到不同版本的 Meteor 后这些附加命令可能需要重新安装。常用开发命令一览创建并运行起第一个应用之后下面这些命令会在日常开发中频繁使用完整说明见 tools/cli/help.txtmeteor add package [package..]向项目添加包。支持版本约束如meteor add package1.1.0表示 1.1.0 及以上不含 2.0.0、meteor add package1.1.0表示精确版本、meteor add package1.0.0 || 2.0.1表示多版本或约束。meteor remove package移除项目中的包。meteor list列出项目显式使用的包--tree显示依赖树--json输出 JSON 格式。meteor update升级项目的 Meteor release 与依赖。--patch只升级补丁版本--release release强制升级到指定 release--packages-only只更新非核心包--all-packages更新包括间接依赖在内的所有包。meteor mongo连接本地开发数据库需要先启动应用--url输出数据库 URL。meteor reset将项目重置为全新状态并清空本地缓存--db同时删除本地数据库。meteor shell在运行中的应用上启动 Node REPL用于交互式求值服务端代码支持 Tab 补全如Meteor.is。meteor build output path为所有平台打包应用输出包含部署所需全部内容的 tarball--server-only跳过移动端构建--directory直接输出目录。meteor deploy site部署到 GalaxyMeteor 的托管服务如myapp.meteorapp.com--settings传入部署专用配置--delete永久删除部署。meteor test --driver-package driver运行应用测试--full-app模式下会完整加载应用后再执行测试。meteor add-platform/remove-platform/list-platforms管理平台server、browser、android、ios添加移动平台后可用meteor run android、meteor run ios等运行到模拟器或真机。卸载 Meteor卸载方式取决于安装方式对应文档见 docs/source/install.md 与根 README.md如果通过 npm 安装运行meteor-installer uninstall如果通过 curl 安装Meteor 除了一小段启动器 shell 脚本外几乎全部安装在你自己的主目录内运行rm -rf ~/.meteor/ sudo rm /usr/local/bin/meteorWindows 用户的卸载说明见 npm-packages/meteor-installer/README.md。深入理解Meteor 工具的启动机制仓库根目录的 meteor 脚本揭示了 Meteor 命令行工具的底层实现它本质上是一个 bash 启动器首先做架构检测仅支持 Linux/Darwin且只接受x86_64与aarch64然后下载并解压预编译的dev bundle包含 Meteor 全部依赖的运行环境如dev_bundle_${PLATFORM}_${BUNDLE_VERSION}.tar.gz最后用 dev bundle 自带的 Node.js 执行 tools/index.js 这一真正的工具入口。该脚本还会自动调高进程可打开文件数上限ulimit并以--max-old-space-size4096启动 Node这些细节决定了 Meteor 在大型项目上的构建稳定性。简单说meteor命令 平台检测 依赖包引导 用内置 Node 运行打包/构建工具链这也是它能做到无需手工配置 Node 版本即可运行的原因。更多工具链设计可以参阅 tools/README.md 和 DEVELOPMENT.md。后续学习资源仓库内 guide 目录收录了完整的 Meteor 开发指南集合、方法、发布订阅、安全、部署、测试、性能优化等主题v3-docs 目录提供了 Meteor 3 的相关文档与迁移指南v3-docs/v3-migration-docs 中收录了 2.x 到 3.0 的迁移说明想了解 Meteor 平台本身的演进历史可阅读根目录 History.md遇到问题想参与贡献仓库根目录的 CONTRIBUTING.md 与 ISSUE_TRIAGE.md 提供了协作流程说明。本文覆盖了从环境准备、三种安装方式、创建多种脚手架项目、启动开发服务器到卸载的完整闭环配合 tools/cli/help.txt 可以随时查阅每条命令的完整参数是 Meteor 入门与日常查阅的实用参考。【免费下载链接】meteorMeteor, the JavaScript App Platform项目地址: https://gitcode.com/gh_mirrors/me/meteor创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考