WordPressEscape

Hem / Guide

Arbetsbänk

Att flytta 528 854 WordPress-sidor till Hugo: tekniska anteckningar

Det här är arbetsanteckningarna från flytten av Unlimited Charters, vår interna systersajt, från WordPress till Hugo i maj 2026. Affärssammanfattningen finns i fallstudien; här går vi igenom det som den som faktiskt ska utföra arbetet behöver veta: vad som gick sönder vid en halv miljon sidor, vilka kommandon som ställde till det och vilka kontroller vi nu kör på alla webbplatser, stora som små.

5 min läsning 9 avsnitt Byggd för att ranka
På den här sidan
  1. Bakgrund
  2. Inventera mallarna före innehållet
  3. Partitionerade byggen och filsystemets fallgropar
  4. Prestandafixar: malländring plus genomgång av hela innehållsmängden
  5. Cloudflare-inställningar som gjorde skillnad
  6. Schema- och SEO-detaljer
  7. Leadgenerering är den del du inte får förlora
  8. Vad vi skulle göra annorlunda
  9. Källor och vidare läsning
  10. Vanliga frågor
Snabbt svar

I den här skalan handlar problemen mer om filsystem och arbetsprocesser än om Hugo: att dela upp bygget, hålla undanlagt innehåll utanför Hugos innehållsmontering, aldrig köra två flyttprocesser mot samma katalog och behandla varje fix som en malländring plus en skriptad genomgång av hela innehållsmängden. De största prestandavinsterna kom från bilddimensioner, synkron kritisk CSS, en LCP-bild som inte lazy-loadas, en fördröjd offertwidget med reserverat utrymme och att stänga av Cloudflare Email Obfuscation.

01

Bakgrund

Unlimited Charters ägs av samma koncern som WordPressEscape. Det här var vår egen testmigrering, genomförd med full åtkomst till servern. Webbplatsen hade drygt en halv miljon URL:er, främst mallbaserade lokala sidor samt hubbsidor, flottasidor och en blogg. Målet var ett Hugo-bygge som levereras som statiska filer bakom Cloudflare, där alla befintliga sökvägar bevaras.

02

Inventera mallarna före innehållet

Vi började med att gruppera URL:erna efter vilken WordPress-mall som renderade dem, inte efter URL-mönster. Varje grupp fick ett beslut: bygg om den som en Hugo-layout eller leverera tills vidare en statisk ögonblicksbild av WordPress-utdata. Genom att bygga om de mest trafikerade grupperna först och skapa ögonblicksbilder av avvikelserna kunde projektet fortsätta utan att fastna i den långa svansen av specialanpassade sidor.

En viktig fallgrop: i WordPress är URL-sökvägen inte alltid samma som sluggen i post_name. Överordnade sidor, anpassade omskrivningsregler och gamla importer skapade sökvägar som inte stämde med sluggen, så sökvägen behövde hämtas från crawlingen, inte från databasen.

03

Partitionerade byggen och filsystemets fallgropar

Att rendera alla sidor i en enda körning gick långsamt och gjorde varje liten ändring dyr. Vi delade därför upp bygget: flytta källfilerna som inte skulle byggas till en tillfällig lagringsplats, bygg en delmängd, distribuera den och återställ sedan filerna. Fyra fallgropar kostade oss tid:

  1. Lagringsplatsen måste ligga utanför Hugos innehållsmontering. Om den ligger någonstans under den monterade innehållskatalogen går Hugo fortfarande igenom alla filer, och uppdelningen ger ingen tidsvinst.
  2. rsync --exclude=index.html exkluderar alla index.html-filer på alla nivåer, inte bara den översta. Förankra mönstret (--exclude=/index.html).
  3. Två samtidiga flyttprocesser mot samma katalog kapslar in den. Två återställningsprocesser som tävlade med varandra skapade omkring 367 000 kataloger en nivå för djupt. Produktionen fungerade eftersom den levererade det färdigbyggda resultatet; ett enda skriptat flyttsteg plattade ut katalogerna. En process äger katalogen, vilket säkerställs med ett lås.
  4. mv dir/* target/ misslyckas i den här storleksordningen (argumentlistan blir för lång). Använd find ... -exec mv -t target {} +.
# rendera ett fåtal sidor utan att bygga om allt
flock /tmp/uc-content.lock bash -c '
  mv content/migrated/* ../stash/            # lagra UTANFÖR innehållsmonteringen
  for s in $(cat targets.txt); do mv ../stash/$s content/migrated/; done
  hugo --minify -d ../staged
  find ../stash -mindepth 1 -maxdepth 1 -exec mv -t content/migrated/ {} +
'
04

Prestandafixar: malländring plus genomgång av hela innehållsmängden

Varje fix hade två delar: korrigera Hugo-mallen så att framtida byggen blev rätt och uppdatera den redan byggda HTML-koden så att vi kunde lansera ändringen utan ett fullständigt ombygge. De viktigaste åtgärderna var:

  • Bilddimensioner. En mall angav hårdkodat width="1600" height="700" medan CSS använde ett annat bildförhållande. Det korrigerades på 527 815 sidor. Bredd och höjd måste motsvara det renderade bildförhållandet, annars reserverar webbläsaren fel utrymme (optimera CLS).
  • Motstridiga regler för bildförhållande fanns för samma selektor i två stilmallar; de slogs ihop till en.
  • Kritisk CSS i den asynkrona filen. Mobilregler som behövdes för den första renderingen låg i en fördröjd stilmall och orsakade en sen omlayout. De flyttades till den synkrona stilmallen.
  • Lazy-loadad hero-bild. loading="lazy" på bilden ovanför vecket fördröjde LCP; det ersattes med fetchpriority="high" (optimera LCP).
  • För stora LCP-bilder byttes mot mindre varianter, vilket sparade 50-440 KB per sida.
  • Offertwidgeten laddas vid den första interaktionen (med en reservlösning via timeout), och dess behållare reserverar 480 px (560 px på mobil). Tidigare flyttade monteringen sidan med ett CLS på omkring 0,54.
05

Cloudflare-inställningar som gjorde skillnad

  • Email Obfuscation avstängt. Dess avkodare går igenom DOM-trädet efter laddning och skriver om e-postlänkar, vilket syntes som layoutförskjutning. Det var den mest ihållande CLS-källan vi hittade.
  • Rocket Loader avstängt. Funktionen ändrar ordningen på skript och störde den fördröjda laddningen.
  • Töm cache efter driftsättning. Edge-cachelagren behöll gammal HTML; genom att tömma cache per sökväg efter varje driftsättning undvek vi att leverera inaktuella sidor (Cloudflares dokumentation om cachetömning).
  • Mät i produktion, inte i staging. Staging utan samma Cloudflare-inställningar gav labbresultat som inte stämde med produktionen.
06

Schema- och SEO-detaljer

  • Search Console rapporterade fel i strukturerad data eftersom en Service-entitet innehöll aggregateRating och review. Vi tog bort dem i stället för att försöka få dem att validera; uppmärkningen måste återspegla det innehåll som användarna faktiskt kan se (riktlinjer för strukturerad data).
  • Blogginlägg renderades först med den lokala mallen och ärvde fel schematyp. Nu deklarerar varje mall sin egen entitet.
  • 35 inkonsekventa flott- och tjänstesökvägar fick permanenta omdirigeringar till rätt nästlade sidor (omdirigeringar).
  • Media flyttades från /wp-content/uploads/ till /uploads/ med en enda 301-regel; en parallell sed-körning skrev om 528 852 av 528 854 filer på några minuter.
  • Yoast togs bort när Hugo började generera sitemap, schema, metataggar och robots.txt.
find static-v5 -name '*.html' -print0 \
  | xargs -0 -P 8 -n 500 sed -i 's|/wp-content/uploads/|/uploads/|g'
07

Leadgenerering är den del du inte får förlora

Offertformuläret är det som genererar intäkter på webbplatsen, så det fick egna kontroller: widgetens monteringspunkt måste finnas i den byggda HTML-koden på alla sidor där den ska visas, fältnamnen måste stämma med det som mottagningsendpointen förväntar sig och en driftsättning som ersätter en katalog får inte ta bort den fristående offert sidan. En övergång där leadgenereringen försvinner kan se lyckad ut enligt alla SEO-mätvärden, samtidigt som verksamheten tappar förfrågningar.

08

Vad vi skulle göra annorlunda

  1. Stäng av Email Obfuscation innan den första CLS-mätningen.
  2. Dela upp bygget redan från dag ett.
  3. Lås innehållskatalogen redan från dag ett.
  4. Dokumentera mönstret med malländring plus genomgång av hela innehållsmängden före den första fixen, inte efter den femte.
  5. Lägg in kontrollen av fältdata (CrUX) i lanseringschecklistan, eftersom labbresultat i staging inte är samma sak som produktion.

Verksamhetsperspektivet på samma projekt, inklusive det vi lät ligga kvar i WordPress, finns i fallstudien.

09

Källor och vidare läsning

Vanliga frågor

Är det här en kundmigrering?

Nej. Unlimited Charters är en intern systersajt som ägs av samma koncern som WordPressEscape. Det är vårt eget testfall.

Klarar Hugo en halv miljon sidor?

Ja, men fullständiga ombyggen går tillräckligt långsamt för att partitionerade byggen och noggrann filhantering ska spela stor roll. De flesta av våra problem handlade mer om filsystem och arbetsprocesser än om buggar i Hugo.

Vad orsakade den värsta layoutförskjutningen?

Offertwidgeten monterades utan reserverat utrymme (omkring 0,54 CLS på hubbsidor), och Cloudflare Email Obfuscation skrev om sidan efter laddningen.

Gäller de här lärdomarna även små webbplatser?

Ja. Samma kontroller (URL-paritet, bilddimensioner, kritisk CSS, hero-bild utan lazy loading och fördröjda widgets) gäller för en webbplats med 40 sidor; de körs bara på minuter i stället för timmar.

Skanna min sajt gratis

Se om din webbplats passar för samma upplägg

Den kostnadsfria 60-sekundersgranskningen visar ditt faktiska PageSpeed-resultat, exakt sidantal, SEO-brister och vilka WordPress-funktioner du behöver ersätta. Därefter bygger WordPressEscape om webbplatsen i Hugo, behåller alla URL:er och lämnar över källkoden dag ett - på samma sätt som UC byggdes om.

Skanna min sajt gratis
Fortsätt läsa
Alla guider33
Relaterade sökningarwordpress till hugo-migrering528 854 sidor (internt test)partitionerat hugo-byggecloudflare cls-fixstädning av strukturerad dataurl-paritet