Beancount срещу hledger: Кой инструмент за текстово базирано счетоводство е подходящ за вас?

Ако сте решили да управлявате финансите си със счетоводство в обикновен текст, вече сте направили интелигентен избор. Вашите финансови данни ще се съхраняват във файлове в четим за човека формат, които контролирате напълно, проследявани с контрол на версиите и без обвързаност с конкретен доставчик. Но сега идва следващият въпрос: кой инструмент трябва да използвате?

Beancount и hledger са двата най-популярни инструмента за счетоводство в обикновен текст (PTA) днес. И двата са с отворен код, поддържат се активно и са способни да се справят с всичко – от лични бюджети до сложни инвестиционни портфейли. Все пак те прилагат фундаментално различни подходи към начина, по който записвате, валидирате и анализирате вашите финансови данни.

Това ръководство разглежда основните разлики, за да можете да изберете този, който най-добре отговаря на вашия работен процес, ниво на опит и нужди от финансово проследяване.

Основната философия: Стриктност срещу Гъвкавост

Най-голямата разлика между Beancount и hledger не е функция – това е начин на мислене.

Beancount е строгият учител. Той предполага, че ще правите грешки при въвеждането на данни, и изгражда защитни механизми, за да ги улови рано. Всяка сметка трябва да бъде изрично открита преди употреба. Всяка трансакция трябва да се балансира до нула. Валутите трябва да следват строг формат. Ако нещо не изглежда правилно, Beancount ще откаже да обработи файла ви, докато не го поправите.

hledger е снизходителният приятел. Той използва по-свободен синтаксис, позволява ви да прескочите предварителното деклариране на сметки и дори може да извлече балансиращи записи чрез предположение. Можете да започнете да проследявате финансите си с минимална настройка и постепенно да добавяте структура с нарастването на нуждите ви.

Нито един от двата подхода не е обективно по-добър. Ако държите на улавянето на грешки, преди те да се превърнат в часове дебъгване, стриктността на Beancount е предимство. Ако искате да започнете бързо и предпочитате гъвкавост, снизходителността на hledger е плюс.

Синтаксис и формат на данните

И двата инструмента съхраняват трансакции в текстови файлове, но правилата на синтаксиса се различават съществено.

Синтаксис на Beancount

2026-03-15 * "Whole Foods" "Weekly groceries"
  Expenses:Food:Groceries    85.42 USD
  Liabilities:CreditCard:Visa

Основни правила:

• Датите използват формат ISO 8601 (YYYY-MM-DD)
• Валутите трябва да бъдат с главни букви (напр. USD, EUR) – без символи като $ или €
• Имената на сметките изискват поне два компонента, разделени с двоеточия (напр. Expenses:Food)
• Описанията трябва да бъдат низове в кавички
• Всички сметки трябва да бъдат изрично открити с директива open

Синтаксис на hledger

2026-03-15 Whole Foods | Weekly groceries
  expenses:food:groceries    $85.42
  liabilities:creditcard:visa

Основни правила:

• По-гъвкави формати за дата
• Разрешени са валутни символи като $ и €
• Имената на сметките могат да бъдат с малки букви и в по-свободна форма
• Описанията нямат нужда от кавички
• Няма нужда от предварително деклариране на сметки

Изводът: По-строгият синтаксис на Beancount означава повече първоначална работа, но по-малко двусмислици. По-свободният синтаксис на hledger е по-лесен за начало, но изисква повече дисциплина за поддържане на консистенция.

Интегритет на данните и валидиране

Това е мястото, където Beancount наистина се отличава.

Твърдения за баланс (Balance Assertions)

И двата инструмента поддържат твърдения за баланс – записи, които проверяват дали вашият регистриран баланс съвпада с банковото ви извлечение. Но те работят по различен начин.

Beancount използва твърдения за баланс с дата, които не зависят от подредбата. Можете да пренареждате файловете с трансакции както желаете и твърденията пак ще работят правилно. Твърденията на hledger зависят от реда във файла, което означава, че преместването на трансакции може да ги наруши.

Проследяване на активи

За всеки, който проследява инвестиции, това е от голямо значение. Beancount налага стриктно завеждане на активите: не можете да продадете акции, които никога не сте купували, и той проследява ценовата база с прецизност. Това предотвратява „разминаване в ценовата база“ – фин проблем, при който изчисленията на капиталовите ви печалби се отклоняват от реалността.

hledger поддържа стоки и партиди (lots), но с по-малко контрол. Той е по-гъвкав, което означава, че е и по-снизходителен към грешки, които може да останат незабелязани до времето за данъци.

Категории сметки

Beancount изисква всяка сметка да принадлежи към една от пет категории: Активи (Assets), Пасиви (Liabilities), Приходи (Income), Разходи (Expenses) или Собствен капитал (Equity). Това ограничение му позволява автоматично да генерира правилни баланси и отчети за приходите и разходите.

hledger позволява произволни йерархии на сметки без изисквани коренни категории. Това ви дава повече свобода, но означава, че трябва ръчно да следвате конвенции, за да получите смислени финансови отчети.

Потребителски интерфейс и отчети

Beancount + Fava

Отличителната черта на Beancount е Fava, изпипан уеб интерфейс, който предоставя:

• Интерактивни диаграми и графики (тенденции в нетната стойност, разбивки на разходите, приходи срещу разходи)
• Визуализации тип „дървовидна карта“ за категориите разходи
• Мощно филтриране по сметка, таг, времеви период и получател
• Език за заявки за персонализирани отчети
• Вграден редактор за вашите файлове на главната книга

Fava се счита за най-добрия потребителски интерфейс в екосистемата на счетоводството в обикновен текст. Ако сте визуален тип човек, който иска табла и графики, това е сериозен аргумент в полза на Beancount.

Интерфейси на hledger

hledger използва подход с множество интерфейси:

• CLI: Богата функционалност за отчети през командния ред с десетки вградени команди (balance, register, incomestatement, cashflow и други)
• hledger-ui: Базиран на терминал потребителски интерфейс за интерактивно преглеждане на сметки и транзакции
• hledger-web: По-опростен уеб интерфейс за основно преглеждане и въвеждане на данни

Интерфейсът за команден ред (CLI) на hledger е по-мощен веднага след инсталация в сравнение с този на Beancount. Ако работите основно в терминала и искате бързи, подлежащи на скриптиране отчети, hledger е правилният избор.

Производителност

hledger е написан на Haskell и обработва приблизително 25 000 транзакции в секунда. За повечето потребители, следящи личните си финанси, и двата инструмента работят практически мигновено. Но ако управлявате голям набор от данни — транзакции за години наред в множество субекти — суровата скорост на hledger му дава предимство.

Beancount (v3) е преписан на C++ в основната си част (парсера), което значително подобрява производителността спрямо оригиналната имплементация на Python. За типична лична употреба или малък бизнес няма да забележите разлика.

Разширяемост и плъгини

Плъгини за Beancount

Beancount има нативна система за плъгини на Python, която е изключително мощна. Плъгините могат да:

• Автоматично разделят транзакции (напр. споделени разходи)
• Генерират повтарящи се транзакции
• Налагат персонализирани правила за валидиране
• Трансформират данни в процеса на обработка

Екосистемата на Python означава, че можете да използвате всяка библиотека на Python във вашите плъгини. Това прави Beancount силно персонализируем за сложни финансови сценарии.

Разширения за hledger

hledger предлага разширяемост чрез:

• Правила за импортиране на CSV за автоматизация на банкови извлечения
• Потребителски скриптове за отчети, използващи изхода от CLI
• HTTP-JSON API за изграждане на интеграции
• Допълнителни команди, базирани на Haskell

Системата за импортиране на CSV на hledger е особено високо ценена — тя прави автоматизирането на импорта на банкови извлечения лесно чрез файлове с правила, които свързват колоните в CSV файла със записите в сметките.

Начални стъпки и крива на обучение

hledger: По-ниска бариера за навлизане

hledger обикновено е по-лесен за начало:

• Инсталирате един изпълним файл (отлична поддръжка за различни платформи, включително Windows)
• Създавате файл и веднага започвате да записвате транзакции
• Няма нужда да декларирате сметки или да следвате стриктни конвенции за именуване
• Изчерпателна и добре поддържана документация
• Активна общност с ресурси, подходящи за начинаещи

Beancount: Повече настройка, повече структура

Beancount изисква повече първоначална настройка:

• Инсталиране на Python и Beancount (и Fava за уеб интерфейса)
• Създаване на декларации за сметки, преди да ги използвате
• Спазване на стриктни синтактични правила от първия ден
• Научаване на петте категории сметки

Компромисът е, че тази първоначална инвестиция се отплаща. Добре структурираната главна книга в Beancount е по-лесна за поддръжка, валидиране и одит с нарастването ѝ.

Общност и екосистема

И двата проекта имат активни и подкрепящи общности:

• Beancount: Активен пощенски списък, нарастваща екосистема от инструменти на трети страни (импортори, плъгини, разширения за Fava) и силна общност от Python разработчици
• hledger: Чести актуализации (приблизително на тримесечие), обширна документация, активни чат канали и по-широката общност на plaintextaccounting.org

И двата инструмента се възползват от по-широкото движение за счетоводство в обикновен текст (plain-text accounting), което означава споделени ресурси, импортори и знания в общността.

Миграция между инструментите

Ако започнете с единия инструмент и по-късно решите да преминете към другия, миграцията е възможна, но не е тривиална:

• От hledger към Beancount: Използвайте hledger print -o tmp.beancount като отправна точка, след което коригирайте синтаксиса (добавете декларации за сметки, коригирайте форматите на валутите, преструктурирайте имената на сметките)
• От Beancount към hledger: Инструментът bean-report може да експортира данни, въпреки че обикновено са нужни ръчни корекции

Споделената философия за обикновен текст означава, че вашите данни никога не са „заключени“. Винаги можете да прочетете и конвертирате файловете си, дори ако процесът изисква известно ръчно почистване.

Таблица за бързо сравнение

Характеристика	Beancount	hledger
Език	Python/C++	Haskell
Стриктност на синтаксиса	Стриктен	Гъвкав
Деклариране на сметки	Задължително	По желание
Най-добър интерфейс	Fava (уеб)	CLI + TUI
Проследяване на инвестиции	Отлично	Добро
Система за плъгини	Python плъгини	Скриптове + API
Импорт на CSV	Чрез импортори	Вградени правила
Крива на обучение	По-стръмна	По-плавна
Проверки на баланса	Независими от реда	Зависими от реда във файла
Производителност	Бърза (v3)	Много бърза
Поддръжка за Windows	Добра	Отлична

Кой инструмент да изберете?

Изберете Beancount, ако:

• Искате красиво уеб табло за визуализация на финансите си
• Проследявате инвестиции и се нуждаете от прецизна обработка на себестойността (cost basis)
• Предпочитате система, която улавя грешките рано и налага последователност
• Чувствате се комфортно с Python и искате мощни възможности за разширение чрез плъгини
• Цените организация на файловете, която не зависи от последователността на записите

Изберете hledger, ако:

• Предпочитате да работите в терминала с бързи, подлежащи на скриптиране отчети
• Искате да започнете бързо с минимална конфигурация
• Нуждаете се от отлична поддръжка за Windows
• Предпочитате гъвкав синтаксис, който се адаптира към вашия стил
• Искате чести версии и активна поддръжка

Истината е: и двата инструмента са отлични. Общността на счетоводството в обикновен текст е гостоприемна, независимо кой инструмент използвате, а уменията, които научавате с единия, се пренасят лесно към другия. Изберете този, който отговаря на вашия работен процес, опитайте го за месец и го сменете, ако е необходимо.

Опростете проследяването на финансите си с Beancount.io

Независимо дали избирате Beancount или hledger, счетоводството в текстов формат ви дава контрол върху вашите финансови данни. Ако искате силата на Beancount с хоствано Fava табло, автоматичен банков импорт и нулево управление на инфраструктурата, Beancount.io прави всичко това без усилия. Започнете безплатно и изпитайте счетоводството в текстов формат без усилия за първоначална настройка.