WordPress原生主题二次开发时，下面这些“高频知识点”建议先吃透。它们既能帮你快速定位要改的文件，也能避免破坏升级路径，90%的日常需求都能覆盖。
模板层级(Template Hierarchy)
先判断“WordPress现在会加载谁?”——同一类页面可以有多份模板，系统按固定优先级依次命中。
单篇文章：single-{post-type}.php→single.php→singular.php→index.php
分类目录：category-{slug}.php→category-{id}.php→category.php→archive.php→index.php
页面：自定义模板(后台可选)→page-{slug}.php→page-{id}.php→page.php→singular.php→index.php
404：404.php→index.php
牢记这条“降级链”，就能精准地把代码写到“最小粒度”文件里，避免整站通用模板写满if/else。
目录组织与最小可用文件
纯技术上index.php+style.css就能被WP识别，但二次开发建议先补齐“安全7件套”：
header.php/footer.php/sidebar.php/functions.php/single.php/page.php/404.php
再按类型分目录：
assets/
├─ css/ ├─ js/ ├─ images/
template-parts/
├─ post/ ├─ page/ ├─ navigation/
inc/
├─ custom-post-type.php ├─ shortcode.php …
在functions.php用require_onceget_template_directory().’/inc/xxx.php’;按需加载，保持主函数文件不过千行。
functions.php的“钩子思维”
只改“钩子”不动核心：
注册菜单register_nav_menus()
注册侧边栏register_sidebar()
注册主题支持add_theme_support(‘post-thumbnails’)
引入资源
add_action('wp_enqueue_scripts', function () {
wp_enqueue_style('main', get_stylesheet_uri(), [], '1.0');
wp_enqueue_script('main', get_template_directory_uri() . '/assets/js/main.js', [], '1.0', true);
});
这样parent主题升级不会覆盖你的逻辑。
子主题(ChildTheme)——二次开发第一站
新建文件夹父主题-child，里面放style.css与functions.php即可。
在style.css头部Template:行填写父主题目录名，WP会自动把父子样式与功能串起来。
想改哪份模板，就把父主题同名文件复制过来再改;父主题升级时你的文件安然无恙。
模板片段(TemplatePart)
复用利器：get_template_part(‘template-parts/content’,’product’)会尝试加载
template-parts/content-product.php→不存在则降级到template-parts/content.php。
把循环(loop)、卡片、导航拆成碎片，代码可读性直接翻倍。
TheLoop循环
任何要输出文章列表的地方都离不开它，最小骨架：
if (have_posts()) :
while (have_posts()) : the_post();
the_title('<h2>', '</h2>');
the_content();
endwhile;
endif;
二次开发常配合setup_postdata($post)或自定义WP_Query做多重循环，记得wp_reset_postdata()还原全局变量。
自定义文章类型&字段(CPT+Meta/ACF)
用register_post_type()与register_taxonomy()写在inc/cpt.php里，模板按层级命名：
archive-{post_type}.php、single-{post_type}.php即可自动命中。
字段输出用get_post_meta(get_the_ID(),’price’,true)或者AdvancedCustomFields的the_field(‘price’)都行，模板里尽量保持“数据–表现”分离，方便后期换前端。
国际化(i18n)
在functions.php里load_theme_textdomain(‘textdomain’,get_template_directory().’/languages’)，
模板里用__()/_e()包起需要翻译的字符串，配合Poedit生成.po/.mo扔到languages目录，后续做多语言站直接上WPML或Polylang即可。
版本与调试
开发阶段wp-config.php里打开WP_DEBUG/WP_DEBUG_LOG，浏览器即时报红。
上线前把style.cssVersion号与wp_enqueue_*的$ver统一，清缓存无烦恼。
任何修改先在子主题或专属插件完成，避免“直接动父主题→升级被覆盖→一夜回到解放前”。
掌握以上9块，就能在不碰WP核心的前提下，把原生主题改造成“高度可维护、可升级、可交接”的定制站。