GNOME Shell扩展设置St.Label正常字重不生效问题排查

• CSS选择器匹配失效：_myText是JavaScript代码中的变量名，St组件不会自动将其注册为可供CSS识别的样式类。你给Label设置的实际样式类只有panel-button，原有CSS中写的StLabel._myText选择器无法匹配到任何组件，对应规则完全不生效。
• 自定义样式表未加载：GNOME Shell不会自动扫描扩展目录下的stylesheet.css文件，原有extension.js代码中完全没有编写样式表加载逻辑，就算CSS规则写的正确，系统也不会加载应用。
• 样式优先级不足：panel-button是GNOME面板的内置通用类，默认主题会为该类定义固定字重规则，自定义样式如果没有足够的选择器优先级，会被内置主题的规则覆盖。

1. 调整JavaScript代码 #

• 为目标Label追加专属的自定义样式类，用于精准匹配组件
• 补充自定义样式表的加载、卸载逻辑，匹配扩展的启用、禁用生命周期
• 避免和其他使用panel-button类的组件产生样式冲突
  修正后的extension.js完整代码：

'use strict';

const { St, Clutter } = imports.gi;
const Main = imports.ui.main;
const ExtensionUtils = imports.misc.extensionUtils;
const Me = ExtensionUtils.getCurrentExtension();

let _myText;
let _currentTheme;

class Extension {
    enable() {
        // 获取全局主题上下文，加载扩展目录下的自定义样式表
        _currentTheme = St.ThemeContext.get_for_stage(global.stage).get_theme();
        const cssPath = Me.dir.get_child('stylesheet.css');
        _currentTheme.load_stylesheet(cssPath);

        _myText = new St.Label({
            text: 'This should be normal font weight.',
            y_align: Clutter.ActorAlign.CENTER,
            // 保留内置panel-button的基础样式，追加自定义专属类名
            style_class: 'panel-button custom-normal-weight-label',
            track_hover: false,
            reactive: false
        });
        Main.panel._leftBox.insert_child_at_index(_myText, 10);
    }

    disable() {
        // 卸载样式表、销毁组件，避免扩展禁用后残留样式
        const cssPath = Me.dir.get_child('stylesheet.css');
        _currentTheme.unload_stylesheet(cssPath);
        _myText.destroy();
        _myText = null;
        _currentTheme = null;
    }
}

function init() {
    return new Extension();
}

2. 修正CSS规则 #

• 替换原来的无效选择器，改为匹配我们刚才添加的自定义类名
• 适当提升规则优先级，覆盖内置主题的默认字重设置
  修正后的stylesheet.css完整代码：

.custom-normal-weight-label {
    font-weight: normal !important;
}

• St组件的CSS选择逻辑仅识别style_class属性中声明的类名，与JS代码中的变量名、对象属性名无任何关联
• GNOME Shell扩展的自定义样式必须随扩展启用主动加载，随扩展禁用主动卸载，避免造成系统全局样式污染
• 针对GNOME内置组件的样式调整，在不影响全局的前提下使用!important是常规操作，可有效避免被内置主题的高优先级规则覆盖

内容的提问来源于stack exchange，提问作者Zany_Zachary1