Hva er LOCKB-filformatet?
En .lockb-fil er den binære låsfilen opprettet av Bun, pakkebehandleren og kjøretidsmiljøet for JavaScript og TypeScript fra Oven. Den heter nesten alltid bun.lockb og ligger i rotmappen til et prosjekt. Bun skriver den når du kjører bun install, og registrerer den komplette løste avhengighetsgrafen: hver pakke, dens nøyaktige versjon, metadata, underavhengigheter og integritetshasher. Ved å låse alt dette kan alle teammedlemmer og CI-jobber installere nøyaktig det samme treet.
Oven bygde formatet som binært for hastighet. Det lagrer data i lineære matriser, refererer til pakker via indeks eller en hash av pakkenavnet, og fjerner duplikater av lange strenger. Filen starter med ASCII-headeren bun-lockfile-format-v0. Ulempen er at en binær låsfil er vanskelig å gjennomgå og vises ikke i Git-differanser, noe som er grunnen til at Bun v1.1.39 la til en tekstbasert låsfil og Bun v1.2 gjorde bun.lock til standard for nye prosjekter. Eksisterende bun.lockb-filer fungerer fortsatt.
Sikkerhet og trygghet
RISIKO: LOWA bun.lockb file is generated data, not an executable, so opening or committing it is safe. Bun can 'run' the file only in the sense that bun ./bun.lockb prints its contents; it does not execute arbitrary code from the file. The only real caution is supply-chain trust: the lockfile pins specific package versions and their sources, so review dependency changes as you would any lockfile update. Never edit it by hand, since a corrupted binary lockfile will fail to parse.
Formatdetaljer
i et nøtteskallProgrammer som åpner LOCKB-filer
bun bun.lockb in the project directory to print the lockfile as readable yarn.lock-style text, or bun install to use it. bun.lockb. bun.lockb and print its contents without installing Bun. bun bun.lockb to print the lockfile as readable text, or bun install to reinstall from it. bun.lockb as text inside the editor. bun.lockb contents in Node or the browser without Bun installed. bun bun.lockb for a readable text dump, or bun install to install dependencies from it. bun.lockb as readable text. git config diff.lockb.textconv bun so git diff shows bun.lockb changes as readable text. Tekniske detaljer
dyp spesifikasjon| Encoding | Binary (serialized struct-of-arrays memory dump) |
| Byte order | Little-endian (native to the machine that wrote it) |
| Container | Flat custom binary format, not a standard container |
| Compression | None; long strings over 88 characters are deduplicated to save space |
| Typical size | A few KB to a few hundred KB depending on dependency count |
| Structure | A header/magic string followed by linear arrays: package list, string buffer, dependency slices, resolutions, and hoisting trees. Packages are referenced by an auto-incrementing index or a hash of the package name rather than by repeated name strings. |
| Integrity | Stores npm-style integrity hashes for each resolved package; the format itself is version-tagged via the header string |
| Platforms | Windows, macOS, Linux |
| Notes | Designed for fast reads and memory mapping. It is not human-readable and does not render in Git or GitHub diffs without a textconv helper. Superseded as the default by the text-based bun.lock (JSONC) in Bun v1.2, but still supported. |
| Human Readable | No |
| Utgitt | 2022 |
| Siste versjon | bun-lockfile-format-v0 |
| Spesifikasjon | github.com |
LOCKB-konverteringer
Spørsmål og svar fra fellesskapet
spurt av brukereIngen spørsmål ennå - vær den første til å spørre om LOCKB-filer.
Ofte stilte spørsmål
Hvordan åpner jeg en bun.lockb-fil?
bun bun.lockb. Bun skriver ut låsfilen som lesbar tekst i yarn.lock-stil. Du må ha Bun installert for dette.Hvorfor er bun.lockb binær i stedet for tekst?
Bør jeg sjekke inn bun.lockb i Git?
Hvordan konverterer jeg bun.lockb til den nye bun.lock?
bun install --save-text-lockfile --frozen-lockfile --lockfile-only, og slett deretter den gamle bun.lockb. Bun v1.2 bruker den tekstbaserte bun.lock som standard for nye prosjekter.Kan jeg redigere en bun.lockb-fil manuelt?
package.json og kjør bun install for å generere låsfilen på nytt. Redigering av binærfilen direkte vil korrumpere den.