wp_enqueue_style必须挂载到wp_enqueue_scripts钩子上，handle需加唯一前缀防冲突，$src须为URL而非路径，$deps和$ver参数不可省略，子主题需显式声明父主题样式依赖。
wp_enqueue_style 必须挂到 wp_enqueue_scripts 钩子上
直接在 functions.php 顶层写 wp_enqueue_style()，函数根本不会执行——PHP 会报 Fatal error: Call to undefined function wp_enqueue_style()；塞进 header.php 里更糟， 已输出，PHP 报 “headers already sent”。WordPress 的资源加载有严格时机：早于 wp_enqueue_scripts（比如 init），WP 环境未就绪；晚于它（比如 wp_head），HTML 已开始渲染，无法插入 <link> 标签。
✅ 正确姿势只有一种：
- 写一个函数封装你的 wp_enqueue_style() 调用
- 用 add_action('wp_enqueue_scripts', 'your_function_name') 挂载它
- 子主题必须在自己的 functions.php 中挂载，不能指望父主题的钩子自动生效（除非父主题显式 do_action('mytheme_enqueue')）
handle 名称重复 = 样式静默失效
你写的 wp_enqueue_style('style', ...) 和插件或父主题里同名的 'style' 冲突时，后注册的那个会把前一个完全覆盖。没有警告、不报错、浏览器里也看不到对应 <link>，CSS 就是不生效——这是最常被误判为“代码没运行”的真凶。
✅ 解决办法：
- handle 加前缀，例如 'mytheme-custom-css'、'childtheme-header-fix'
- 检查是否已被加载：wp_style_is('mytheme-custom-css', 'enqueued') 返回 true 表示已存在
- 若需替换主题默认样式（如 'twentytwentyfour-style'），先 wp_dequeue_style('twentytwentyfour-style')，再 wp_enqueue_style()
$src 必须是 URL，不是路径
常见错误是把服务器文件路径当 URL 传进去，比如 __DIR__ . '/assets/css/main.css' 或 get_template_directory() . '/style.css'，结果生成 404。WordPress 不解析服务器路径，它只认能被浏览器直接请求的完整 URL。
✅ 正确写法取决于上下文：
- 主题根目录下的 style.css：get_stylesheet_uri()
- 父主题 CSS（子主题中引用）：get_template_directory_uri() . '/assets/css/main.css'
- 子主题自定义 CSS：get_stylesheet_directory_uri() . '/css/custom.css'
- 插件内 CSS：plugin_dir_url(__FILE__) . 'css/admin.css'（比 plugins_url() 更稳，尤其在符号链接或多站点下）
依赖和版本参数不能省略
省略 $deps 或 $ver 参数，在 PHP 8+ 下会触发 warning；更重要的是，不声明依赖会导致样式加载顺序错乱——比如你自定义 CSS 依赖 Bootstrap，但没写 array('bootstrap')，你的规则可能被 Bootstrap 覆盖；不传版本号则浏览器强缓存旧 CSS，改了也不生效。
立即学习“前端免费学习笔记（深入）”；
✅ 推荐写法：
- 无依赖也必须显式写 array()
- 版本号用 filemtime(get_template_directory() . '/assets/css/main.css')，文件一改，URL 后缀自动变，彻底绕过缓存
- 媒体类型 $media 按需填，比如打印样式用 'print'，别总默认 'all'
真正容易被忽略的点是：子主题里想继承父主题样式，不能只靠 @import，必须用 wp_enqueue_style() 显式声明依赖关系，否则父主题 CSS 可能异步加载、阻塞渲染，或被其他插件提前干掉。这个链路一旦断开，调试成本远高于写对那几行函数调用。
