PyCharm 2025.3 Help

Meteor

Meteor 是一个全栈框架，可让您在客户端和服务器端同时使用 JavaScript。 PyCharm 与 Meteor 集成，您可以在 IDE 内使用 Meteor。 PyCharm 对 Meteor 的支持包括：

  • 通过检测 .meteor 文件夹并将 .meteor/local 文件夹从项目中排除，自动识别 Meteor 项目。 有关详细信息，请参阅 隐藏已排除的文件。

  • 自动将预定义的 Meteor 库附加到项目中。 这将启用语法高亮、引用解析和代码补全。

  • 通过 Handlebars 支持 Spacebars，并为 if 和 each 指令提供补全。 PyCharm 能识别 Spacebars 模板，但因此会将 Meteor 项目中的 HTML 文件标记为 Handlebars/Mustache 图标。 PyCharm 提供 JavaScript 源代码与模板之间的导航，可使用 转到声明 Ctrl+B。

  • 提供专用且复杂的 Meteor 运行/调试配置，可在一次调试会话中同时调试客户端和服务器端代码，参阅 调试 Meteor 应用。

开始之前

  1. 请确保您的计算机上已安装 Node.js。

  2. 请确保在设置中启用了 JavaScript and TypeScript 插件。 按 Ctrl+Alt+S 打开设置，然后选择 插件。 点击 已安装 选项卡。 在搜索字段中，输入 JavaScript and TypeScript。 有关插件的更多信息，请参阅 管理插件。

  3. 按照 从 JetBrains Marketplace 安装插件 中的说明，在 设置 | 插件 页面、 Marketplace 选项卡上安装 Meteor 和 Handlebars/Mustache 插件。

安装 Meteor

安装过程取决于您使用的操作系统。 更多信息请参见 Meteor 官方网站。

  • 在嵌入式 终端 （Alt+F12 ）中，键入：

    $ curl https://install.meteor.com | /bin/sh

  • 在嵌入式 终端 （Alt+F12 ）中，键入：

    $ curl https://install.meteor.com | /bin/sh

创建新的 Meteor 应用

如果您还没有应用，您可以从 Meteor 样板模板生成具有 Meteor 特定结构的 一个 PyCharm 项目。 或者，创建一个空的 PyCharm 项目，并按照下文 从现有的 Meteor 应用开始 中的说明在其中配置 Meteor 支持。

从样板模板创建 Meteor 项目

  1. 从主菜单中点击 文件 | 新建 | 项目。 或者，在欢迎屏幕的左侧窗格中点击 新建 | 新建项目。

    将打开 新建 项目 对话框。

  2. 在左侧窗格中，选择 Meteor。

  3. 在右侧窗格中：

    1. 指定存储项目相关文件的文件夹路径。

    2. 指定 Meteor 可执行文件的位置（参阅 安装 Meteor）。

    3. 在 模板 列表中，选择要生成的示例。 若要生成基本的项目结构，请选择 默认 选项。

    4. 在 文件名 字段中，键入将要生成的相互关联的 .js 、 .html 和 .css 文件的名称。 仅当在 模板 下拉列表中选择了 Default 示例类型时，才会提供此字段。

创建空的 PyCharm 项目

  1. 从主菜单中点击 文件 | 新建 | 项目。 或者，在欢迎屏幕的左侧窗格中点击 新建 | 新建项目。

    将打开 新建 项目 对话框。

  2. 在左侧窗格中，选择 空 项目。 在右侧窗格中，指定应用程序文件夹，然后点击 创建。

从现有的 Meteor 应用开始

如果您将继续开发现有的 Meteor 应用，请在 PyCharm 中将其打开，在其中配置 Meteor，并按照下文 下载 Meteor 依赖项 中的说明下载所需的依赖项。

打开已在您机器上的应用源代码

  • 在 欢迎 屏幕的左侧窗格中点击 打开 ，或从主菜单中选择 文件 | 打开。 在打开的对话框中，选择存储源代码的文件夹。

从您的版本控制检出应用源代码

  1. 在 欢迎 屏幕的左侧窗格中点击 克隆。

    或者，从主菜单中选择 文件 | 新建 | 来自版本控制的项目… 或 Git | 克隆… 或 VCS | 从版本控制获取。

    在主菜单中，您可能会看到与项目关联的其他任何版本控制系统，而不是 Git。 例如， Mercurial 或 Perforce。

  2. 在打开的对话框中，从列表中选择您的版本控制系统，并指定要从中检出的应用源代码的存储库。 有关详细信息，请参阅 检出项目（克隆）。

在现有项目中配置 Meteor 支持

  1. 在 设置 对话框（Ctrl+Alt+S ）中，转到 语言 & 框架 | JavaScript | Meteor。 将打开 Meteor 页面。

  2. 指定 Meteor 可执行文件的路径。 如果您遵循了标准的安装过程，PyCharm 会自动检测该文件。

  3. 要将 .meteor/local 文件夹及其内容包含到索引中，请清除 在打开项目时自动排除 ".meteor/local" 目录 复选框。 有关详细信息，请参阅下文 隐藏已排除的文件。

  4. 请确保已选中 自动将 Meteor 软件包作为外部库导入 复选框。

    • 选中该复选框后，PyCharm 会自动从 meteor/packages 文件导入外部包。 因此，PyCharm 会提供全面的代码辅助：解析对 Meteor 内置函数（例如 check(true) ）和第三方包中函数的引用，提供正确的语法和错误高亮显示，支持使用 source map 进行调试，等等。

    • 清除此复选框时，PyCharm 不会自动从 meteor/packages 文件导入外部包。 因此不提供任何代码辅助。 为改善这种情况，请在编辑器中打开 meteor/packages 文件，点击 将软件包作为库导入 链接或运行 meteor --update 命令。

  5. 确保 PyCharm 已将 Meteor 库附加到项目中。

    1. 在 设置 对话框（Ctrl+Alt+S ），转到 语言 & 框架 | JavaScript | 库。

    2. 在打开的 设置： JavaScript 库 页面上，确保 库 列表中 Meteor 项目库旁边的复选框已选中。

项目安全

当您打开在 PyCharm 之外创建并导入到其中的项目时，PyCharm 会显示一个对话框，您可以在其中决定如何处理包含不熟悉源代码的该项目。

不受信任的项目警告

请选择以下选项之一：

  • 在安全模式下预览 ：在这种情况下， PyCharm 以预览模式打开项目。 这意味着您可以浏览项目的源代码，但无法运行任务和脚本，也不能运行/调试您的项目。

    PyCharm 会在编辑器区域顶部显示通知，您可以随时点击 信任项目… 链接加载项目。

  • 信任项目 ：在这种情况下， PyCharm 打开并加载项目。 这意味着项目已初始化、项目插件已解析、已添加依赖项，并且所有 PyCharm 功能均可用。

  • 不打开 ：在这种情况下， PyCharm 不打开项目。

欲了解详细信息，请参阅 项目安全性。

导入 Meteor 包

除了预定义的 Meteor 库（确保基本的 Meteor 特定代码辅助功能），您还可以下载在 .meteor/local/packages 文件中定义的额外 包。

下载其他 Meteor 包

  1. 在编辑器中打开 .meteor/local/packages 文件。

  2. 点击屏幕右上角的 导入 Meteor 软件包 链接。

  3. 在打开的对话框中，根据您计划在项目中开发的应用程序类型，指定要下载的包。

    • 客户端

    • 服务器

    • Cordova ：选择此选项以导入支持开发 iOS 和 Android 的 Meteor 应用程序的包。有关更多信息，请参阅 Meteor Cordova Phonegap 集成。

PyCharm 会自动将用于存储已构建应用程序的 .meteor/local 文件夹标记为 排除 ，但仍会在项目树中显示它。

隐藏 .meteor/local 文件夹

  • 点击 显示选项菜单 按钮，该按钮位于 项目 工具窗口 Alt+1 的工具栏上，并取消选中 显示已排除的文件 选项旁的勾选。

运行 Meteor 应用

PyCharm 根据类型为 Meteor 的运行配置运行 Meteor 应用程序。 如果您从样板模板创建了应用程序，PyCharm 会为您生成此运行配置。

创建 Meteor 运行配置

  1. 在工具栏上的 运行/调试配置 小部件中选择 编辑配置 ，点击 添加新配置 按钮（添加新配置按钮 ），并在列表中选择 Meteor 以打开 配置设置。

    开始创建运行/调试配置

  2. 在 配置 选项卡中，根据安装情况指定 Meteor 可执行文件的路径（请参阅 安装 Meteor）。

  3. 指定存储要运行的应用程序文件的文件夹。 该文件夹的根目录下必须包含一个 .meteor 子文件夹，这样 PyCharm 才能将您的应用程序识别为 Meteor 项目。

    默认情况下，工作目录是项目的根文件夹。

可选

  1. 在 程序参数 字段中，指定在启动时传递给可执行文件的命令行附加参数（如果适用）。 例如，这些可以是 --dev、 --test 或 --prod ，用于指示应用程序运行的环境（开发、 测试 或 生产 环境），以便在启动时加载不同的资源。

  2. 默认情况下，PyCharm 在 运行 工具窗口中显示应用程序输出。 要查看客户端代码执行的结果，请在 浏览器/实时编辑 选项卡中选择 启动后 复选框，并从列表中选择要打开的浏览器。 在下面的字段中，指定用于打开应用程序的 URL 地址。 默认值是 http://localhost:3000 。

运行 Meteor 应用

  1. 如上所述创建运行/调试配置 ，或修改现有配置，并在对话框中点击 运行。

    或者，在主工具栏的列表中选择新创建的运行配置，然后点击 运行按钮。

  2. 在 运行 工具窗口或浏览器中查看应用程序输出（如果您已配置浏览器在应用程序启动时打开） 如上所述。

调试 Meteor 应用

使用 PyCharm，您可以在一个调试会话中调试 Meteor JavaScript 代码的 客户端 和 服务器端。 调试会话仅通过专用的 Meteor 运行配置启动。

从技术上讲，实现不同应用程序的多个 Meteor 项目可以合并到一个 PyCharm 项目中。 要独立运行和调试这些应用程序，请为每个应用程序创建单独的运行配置，并指定相应的工作目录。 为避免端口冲突，这些运行配置应使用不同的端口。 在 程序参数 字段中，以 --port=<port_number> 格式为每个运行配置指定单独的端口。

  1. 在需要的代码位置设置 断点。

  2. 创建一个 Meteor 运行/调试配置， 如上所述。 在 浏览/实时编辑 选项卡中，选择 启动后 复选框，从列表中选择 Chrome ，并选择 使用 JavaScript 调试器 复选框。

  3. 要启动调试会话，请从主工具栏的列表中选择所需的调试配置，然后点击列表旁的 调试按钮 ，或从主菜单中选择 运行 | 调试 <配置名称>。

    调试 工具窗口打开，显示两个选项卡：一个用于调试标记为 Meteor 图标 的服务器端代码，另一个用于调试标记为 JavaScript 图标 的客户端代码。

  4. 探索挂起的程序 并 逐步执行程序。

  5. 可选地，实时预览对应用程序的更改 如下面所述。

在浏览器中预览更改

在调试会话期间，您可以实时预览对 HTML、CSS 或 JavaScript 代码的更改。 您编辑的页面的实时内容显示在 Elements 选项卡的 调试工具窗口 中。 更新策略取决于您正在编辑的应用程序部分。

预览对客户端代码的更改

  • 切换到 <配置名称> JavaScript JavaScript 图标 选项卡，并点击工具栏上的 更新。

  • 通过在 Meteor 页面上选择 启用 Meteor 热代码推送 复选框来配置更新的自动上传。 了解更多信息，请访问 Meteor 官方网站。

预览对服务器端代码的更改

  • 切换到 <配置名称> Meteor 图标 选项卡，并点击工具栏上的 更新。

  • 按照 HTML、CSS 和 JavaScript 中的实时编辑 中的描述，使用 实时编辑 功能配置自动上传。 建议您在 页面 上选择 在热替换失败时重新启动 复选框，然后 PyCharm 将尝试重新加载页面（如果更改无法直接应用）。

最后修改日期： 2025年 12月 2日
Closure Linter最小化 JavaScript