PyCharm 2026.1 Help

Compass 应用中的 Sass 和 SCSS

在开始之前

  1. 下载并安装 Ruby

  2. 按照 CompassFile Watchers 中的描述,在 设置 | 插件 页,选项卡 Marketplace 上安装 从 JetBrains Marketplace 安装插件。 插件仅在 PyCharm 专业版中可用。

安装 Compass

  • 在内置的 终端Alt+F12 )中,键入:

    gem install compass

    Compass 安装在与 Ruby 可执行文件和 gem.bat 文件相同的文件夹中。

创建新的 Compass 应用

如果您尚无 Compass 应用,您可以创建一个,或向空的 PyCharm 项目添加 Compass 支持。 无论哪种情况,都会生成一个 conf.rb 配置文件。

  • 在内置的 终端Alt+F12 )中,键入:

    compass create <the name of the application to be created>

  • 创建一个空的 PyCharm 项目,打开嵌入式 终端Alt+F12 ),然后键入:

    cd <application folder> compass init

在您的应用中启用对 Compass 的支持

  1. 打开一个 .sass .scss 文件,点击 @import 'compass' 语句旁的红色灯泡,或按 Alt+Enter ,然后在建议列表中选择 配置 Compass

  2. 选中 启用 Compass 支持 复选框,并指定 Compass 可执行文件和 conf.rb 配置文件的路径。

从现有 Compass 应用开始

打开您计算机上已有的应用源代码

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

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

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

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

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

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

编译 Sass 和 SCSS

要自动编译您的代码,您需要安装编译器并配置一个 Compass Sass 或 Compass SCSS 文件监视器 ,用于跟踪文件更改并运行编译器。

PyCharm 在您打开文件时会检查当前项目中是否有可用的文件监视器。 如果已配置此类文件监视器但处于禁用状态,PyCharm 会显示一个弹出窗口,告知您已配置的文件监视器并建议启用它。

如果在当前项目中已配置并启用了适用的文件监视器,PyCharm 会在 新建监视器对话框 中指定的事件发生时自动启动编译器。

  • 如果选中 自动保存已编辑的文件以触发监视器 复选框,则在对源代码进行任何更改后会立即调用文件监视器。

  • 如果清除 自动保存已编辑的文件以触发监视器 复选框,则会在保存时(文件 | 全部保存Ctrl+S )或将焦点从 PyCharm 移开时(框架停用时)启动文件监视器。

文件监视器 了解更多信息。

PyCharm 会创建一个包含生成输出的单独文件。 该文件与源 Sass 或 SCSS 文件同名,扩展名为 .css 。 生成文件的位置在 要刷新输出路径 字段中定义,位于 新建监视器对话框 中。 不过,在 项目树 中,它们会显示在源文件下方,源文件此时显示为一个节点。

创建文件监视器

  1. 设置 对话框(Ctrl+Alt+S )中,在 工具 下点击 文件监视器。 打开的 文件监视器页面显示已配置的文件监视器列表。

  2. 点击 Add 按钮 ,或按 Alt+Insert。 根据您要使用的工具,从列表中选择 compass sasscompass scss 预定义模板。 将打开 新建监视器对话框

  3. 程序 字段中,指定可执行文件的路径:

    • compass.bat (适用于 Windows)

    • compass (适用于 Unix 和 macOS)

  4. 参数 字段中,根据所用操作系统输入以下之一:

    • compile $UnixSeparators($ProjectFileDir$)$ 用于处理整个目录

    • compile $UnixSeparators($FilePath$)$ 用于处理单个文件

    • compile $ProjectFileDir$ 用于处理整个目录

    • compile $ProjectFileDir$ $FilePath$ 用于处理单个文件

    • compile $ProjectFileDir$ 用于处理整个目录

    • compile $ProjectFileDir$ $FilePath$ 用于处理单个文件

  5. 文件监视器 中所述进行。

2026年 3月 24日