WordPress不识别纯HTML文件，需将其拆解为符合规范的PHP模板（如header.php、footer.php、index.php）并配置style.css；静态资源须用wp_enqueue_style/script加载；输出HTML需通过get_template_part等安全方式。
HTML 文件怎么塞进 WordPress 主题目录里
直接扔进去不行，wordpress 不认纯 html 页面。它需要的是符合主题规范的 php 模板文件，比如 index.php、header.php、footer.php，还要有 style.css 声明主题信息。
实操上不是“改 HTML”，而是把 HTML 结构拆开，嵌进 WordPress 的模板钩子和函数里：
- 把原 HTML 的头部（
<head>及其内容）抽出来，放进header.php，并在里面加wp_head() - 把底部（
<footer>等）放进footer.php，末尾加wp_footer() - 把主体内容区域（比如
<main>或<div class="content">）放进index.php，中间用while (have_posts()) : the_post();包裹动态内容输出 -
style.css开头必须有注释块，至少含Theme Name、Author、Version，否则后台看不到这个主题
静态 CSS/JS 怎么让 WordPress 正确加载
直接在 header.php 里写 <link rel="stylesheet"> 或 <script> 标签会失效——可能被缓存干扰、路径错、加载时机不对，更严重的是破坏子主题继承和插件兼容性。
必须用 wp_enqueue_style() 和 wp_enqueue_script() 注册并入队：
- 所有静态资源路径要用
get_template_directory_uri()（父主题）或get_stylesheet_directory_uri()（子主题），不能写死/wp-content/themes/xxx/ - CSS 要在
wp_enqueue_scripts钩子里注册，JS 如果依赖 jQuery，得声明array('jquery')为第二个参数 - 避免在
functions.php顶部直接 echo script 标签，那会破坏 HTTP 头发送，导致白屏或 “Headers already sent” 错误
示例：
function mytheme_scripts() {
wp_enqueue_style('mytheme-style', get_template_directory_uri() . '/style.css');
wp_enqueue_script('mytheme-script', get_template_directory_uri() . '/js/main.js', array(), '1.0.0', true);
}
add_action('wp_enqueue_scripts', 'mytheme_scripts');
PHP 模板里怎么安全输出 HTML 原内容
别直接 echo $html_string 或 include('page.html') —— 这样既绕过 WordPress 的过滤机制，又容易被 XSS 攻击，还无法使用 the_content() 等富文本解析逻辑。
立即学习“前端免费学习笔记（深入）”；
真正要保留原始结构又兼容 WordPress，得靠三类处理方式：
- 用
get_template_part()拆分复用区块，比如get_template_part('template-parts/content', 'hero')对应template-parts/content-hero.php - 自定义页面模板（Page Template）：在 PHP 文件顶部加注释
/* Template Name: Landing Page */，然后在后台新建页面时手动指定 - 如果必须插入一段静态 HTML 片段，用
wp_kses_post()过滤后再输出，而不是wp_kses_allowed_html()自行配置白名单——后者极易漏掉关键标签，反而埋坑
为什么本地预览正常，上线后样式全乱或 JS 报错
常见原因不是代码写错了，而是路径和上下文环境变了。WordPress 的 URL 结构、多站点开关、子目录安装、HTTPS 强制跳转都会影响资源加载。
排查重点在三个地方：
- 浏览器开发者工具里看 Network 面板，找 404 的 CSS/JS 请求，点开看实际请求地址——大概率是用了相对路径或硬编码域名
- 检查
wp-config.php是否定义了WP_HOME和WP_SITEURL，和后台「设置 → 常规」里的地址不一致时，get_site_url()会返回错误结果 - 禁用所有插件再试；有些插件（尤其缓存类、安全类）会重写输出、拦截脚本、甚至修改
wp_head输出顺序，导致样式覆盖或 JS 执行失败
最常被忽略的一点：主题根目录下没有 index.php，或者它没包含 get_header() 和 get_footer() —— WordPress 就当这个主题不存在，自动回退到默认主题，你改的所有东西都白忙。
