{"id":120931,"date":"2025-11-20T15:27:56","date_gmt":"2025-11-20T08:27:56","guid":{"rendered":"https:\/\/tino.vn\/blog\/?p=120931"},"modified":"2025-11-20T15:29:15","modified_gmt":"2025-11-20T08:29:15","slug":"file-init-py-trong-python","status":"publish","type":"post","link":"https:\/\/tino.vn\/blog\/file-init-py-trong-python\/","title":{"rendered":"T\u00ecm hi\u1ec3u file __init__.py trong Python: Vai tr\u00f2, c\u01a1 ch\u1ebf ho\u1ea1t \u0111\u1ed9ng v\u00e0 l\u00fd do c\u1ea7n s\u1eed d\u1ee5ng"},"content":{"rendered":"\n

Khi tham gia v\u00e0o c\u00e1c d\u1ef1 \u00e1n ph\u1ea7n m\u1ec1m quy m\u00f4 l\u1edbn ho\u1eb7c nghi\u00ean c\u1ee9u m\u00e3 ngu\u1ed3n c\u1ee7a c\u00e1c th\u01b0 vi\u1ec7n n\u1ed5i ti\u1ebfng, l\u1eadp tr\u00ecnh vi\u00ean th\u01b0\u1eddng xuy\u00ean b\u1eaft g\u1eb7p t\u1eadp tin __init__.py n\u1eb1m trong h\u1ea7u h\u1ebft c\u00e1c th\u01b0 m\u1ee5c con. D\u00f9 l\u00e0 m\u1ed9t th\u00e0nh ph\u1ea7n c\u01a1 b\u1ea3n, nh\u01b0ng __init__.py th\u01b0\u1eddng g\u00e2y b\u1ed1i r\u1ed1i cho nh\u1eefng ng\u01b0\u1eddi m\u1edbi b\u1eaft \u0111\u1ea7u l\u00e0m quen v\u1edbi Python<\/a>, \u0111\u1eb7c bi\u1ec7t l\u00e0 v\u1ec1 ch\u1ee9c n\u0103ng th\u1ef1c t\u1ebf c\u1ee7a t\u1eadp tin n\u00e0y trong c\u00e1c phi\u00ean b\u1ea3n Python hi\u1ec7n \u0111\u1ea1i. C\u00f9ng Tino t\u00ecm hi\u1ec3u vai tr\u00f2 c\u1ee7a file __init__.py<\/strong> trong Python qua b\u00e0i vi\u1ebft d\u01b0\u1edbi \u0111\u00e2y nh\u00e9!<\/strong><\/p>\n\n\n\n

<\/a>T\u1ed5ng quan v\u1ec1 file __init__.py trong Python<\/h2>\n\n\n\n

<\/a>File __init__.py trong Python l\u00e0 g\u00ec?<\/strong><\/h3>\n\n\n\n

Trong ki\u1ebfn tr\u00fac m\u00e3 ngu\u1ed3n Python, __init__.py l\u00e0 m\u1ed9t t\u1eadp tin k\u1ecbch b\u1ea3n (script) \u0111\u1eb7c bi\u1ec7t \u0111\u00f3ng vai tr\u00f2 x\u00e1c \u0111\u1ecbnh danh t\u00ednh cho m\u1ed9t th\u01b0 m\u1ee5c, bi\u1ebfn th\u01b0 m\u1ee5c ch\u1ee9a t\u1eadp tin n\u00e0y tr\u1edf th\u00e0nh m\u1ed9t Python Package (g\u00f3i ph\u1ea7n m\u1ec1m) ch\u00ednh th\u1ee9c \u0111\u1ec3 tr\u00ecnh th\u00f4ng d\u1ecbch c\u00f3 th\u1ec3 nh\u1eadn di\u1ec7n v\u00e0 x\u1eed l\u00fd.<\/p>\n\n\n\n

Khi m\u1ed9t package \u0111\u01b0\u1ee3c import v\u00e0o ch\u01b0\u01a1ng tr\u00ecnh, c\u00e1c m\u00e3 l\u1ec7nh n\u1eb1m b\u00ean trong __init__.py s\u1ebd t\u1ef1 \u0111\u1ed9ng \u0111\u01b0\u1ee3c th\u1ef1c thi \u0111\u1ea7u ti\u00ean, cho ph\u00e9p l\u1eadp tr\u00ecnh vi\u00ean thi\u1ebft l\u1eadp m\u00f4i tr\u01b0\u1eddng kh\u1edfi t\u1ea1o, \u0111\u1ecbnh ngh\u0129a c\u00e1c bi\u1ebfn to\u00e0n c\u1ee5c c\u1ea7n thi\u1ebft ho\u1eb7c ki\u1ec3m so\u00e1t kh\u00f4ng gian t\u00ean (namespace) b\u1eb1ng c\u00e1ch gom nh\u00f3m v\u00e0 \u0111\u01a1n gi\u1ea3n h\u00f3a vi\u1ec7c truy xu\u1ea5t c\u00e1c module con.<\/p>\n\n\n

\n
\"File
File __init__.py trong Python l\u00e0 g\u00ec?<\/strong><\/figcaption><\/figure>\n<\/div>\n\n\n

D\u00f9 n\u1ed9i dung b\u00ean trong c\u00f3 th\u1ec3 ho\u00e0n to\u00e0n \u0111\u1ec3 tr\u1ed1ng, s\u1ef1 hi\u1ec7n di\u1ec7n c\u1ee7a __init__.py v\u1eabn l\u00e0 d\u1ea5u hi\u1ec7u k\u1ef9 thu\u1eadt ti\u00eau chu\u1ea9n \u0111\u1ec3 ph\u00e2n bi\u1ec7t m\u1ed9t package Python v\u1edbi c\u00e1c th\u01b0 m\u1ee5c l\u01b0u tr\u1eef d\u1eef li\u1ec7u th\u00f4ng th\u01b0\u1eddng.<\/p>\n\n\n\n

<\/a>C\u1ea5u tr\u00fac c\u01a1 b\u1ea3n c\u1ee7a file __init__.py<\/strong><\/h3>\n\n\n\n

<\/a>C\u1ea5u tr\u00fac ti\u00eau chu\u1ea9n c\u1ee7a __init__.py<\/h4>\n\n\n\n

<\/p>\n\n\n\n

Th\u00f4ng th\u01b0\u1eddng, n\u1ed9i dung c\u1ee7a t\u1eadp tin kh\u1edfi t\u1ea1o n\u00e0y \u0111\u01b0\u1ee3c chia th\u00e0nh 4 ph\u1ea7n ch\u00ednh theo th\u1ee9 t\u1ef1 t\u1eeb tr\u00ean xu\u1ed1ng d\u01b0\u1edbi:<\/p>\n\n\n\n

    \n
  1. Module Docstring (T\u00e0i li\u1ec7u m\u00f4 t\u1ea3):<\/strong> Gi\u1edbi thi\u1ec7u ng\u1eafn g\u1ecdn v\u1ec1 m\u1ee5c \u0111\u00edch c\u1ee7a package.<\/li>\n\n\n\n
  2. Package Metadata (Si\u00eau d\u1eef li\u1ec7u):<\/strong> \u0110\u1ecbnh ngh\u0129a phi\u00ean b\u1ea3n, t\u00e1c gi\u1ea3.<\/li>\n\n\n\n
  3. API Exposition (C\u00f4ng khai giao di\u1ec7n):<\/strong> Import c\u00e1c class\/h\u00e0m t\u1eeb module con l\u00ean c\u1ea5p package.<\/li>\n\n\n\n
  4. Export Control (Ki\u1ec3m so\u00e1t xu\u1ea5t kh\u1ea9u):<\/strong> \u0110\u1ecbnh ngh\u0129a danh s\u00e1ch __all__.<\/li>\n<\/ol>\n\n\n
    \n
    \"C\u1ea5u
    C\u1ea5u tr\u00fac c\u01a1 b\u1ea3n c\u1ee7a file __init__.py<\/strong><\/figcaption><\/figure>\n<\/div>\n\n\n

    <\/a>V\u00ed d\u1ee5 m\u00e3 ngu\u1ed3n m\u1eabu (Template)<\/h4>\n\n\n\n

    <\/p>\n\n\n\n

    Gi\u1ea3 s\u1eed ch\u00fang ta \u0111ang x\u00e2y d\u1ef1ng m\u1ed9t package x\u1eed l\u00fd d\u1eef li\u1ec7u t\u00ean l\u00e0 data_toolkit. D\u01b0\u1edbi \u0111\u00e2y l\u00e0 n\u1ed9i dung file data_toolkit\/__init__.py<\/em>:<\/p>\n\n\n\n

    \"\"\"\ndata_toolkit\n~~~~~~~~~~~~\n\nG\u00f3i ph\u1ea7n m\u1ec1m h\u1ed7 tr\u1ee3 x\u1eed l\u00fd v\u00e0 ph\u00e2n t\u00edch d\u1eef li\u1ec7u hi\u1ec7u su\u1ea5t cao.\nCung c\u1ea5p c\u00e1c c\u00f4ng c\u1ee5 \u0111\u1ec3 \u0111\u1ecdc, ghi v\u00e0 chuy\u1ec3n \u0111\u1ed5i \u0111\u1ecbnh d\u1ea1ng d\u1eef li\u1ec7u.\n\"\"\"\n\n# --- PH\u1ea6N 1: METADATA (TH\u00d4NG TIN G\u00d3I) ---\n# C\u00e1c bi\u1ebfn dunder (double underscore) gi\u00fap \u0111\u1ecbnh danh phi\u00ean b\u1ea3n v\u00e0 t\u00e1c gi\u1ea3\n__version__ = \"1.0.2\"\n__author__ = \"Ten Cua Ban\"\n__email__ = \"contact@example.com\"\n\n\n# --- PH\u1ea6N 2: API EXPOSITION (L\u00c0M PH\u1eb2NG NAMESPACE) ---\n# S\u1eed d\u1ee5ng import t\u01b0\u01a1ng \u0111\u1ed1i (relative import) \u0111\u1ec3 \u0111\u01b0a c\u00e1c class quan tr\u1ecdng ra ngo\u00e0i.\n# Thay v\u00ec: from data_toolkit.readers.csv_reader import CSVReader\n# Ng\u01b0\u1eddi d\u00f9ng ch\u1ec9 c\u1ea7n: from data_toolkit import CSVReader\n\nfrom .readers.csv_reader import CSVReader\nfrom .readers.json_reader import JSONReader\nfrom .writers.file_writer import DataWriter\nfrom .utils.common import validate_data\n\n\n# --- PH\u1ea6N 3: EXPORT CONTROL (KI\u1ec2M SO\u00c1T PH\u1ea0M VI) ---\n# Ch\u1ec9 \u0111\u1ecbnh r\u00f5 nh\u1eefng th\u00e0nh ph\u1ea7n n\u00e0o s\u1ebd \u0111\u01b0\u1ee3c xu\u1ea5t hi\u1ec7n khi d\u00f9ng l\u1ec7nh:\n# from data_toolkit import *\n# C\u00e1c module kh\u00e1c (nh\u01b0 c\u00e1c h\u00e0m n\u1ed9i b\u1ed9) s\u1ebd b\u1ecb \u1ea9n \u0111i.\n\n__all__ = [\n    \"CSVReader\",\n    \"JSONReader\",\n    \"DataWriter\",\n    \"validate_data\",\n    \"__version__\",\n]<\/code><\/pre>\n\n\n\n
    <\/a>Ph\u00e2n t\u00edch chi ti\u1ebft t\u1eebng th\u00e0nh ph\u1ea7n<\/h4>\n\n\n\n
    Docstring (Chu\u1ed7i t\u00e0i li\u1ec7u):<\/span><\/strong><\/p>\n\n\n\n
    Lu\u00f4n b\u1eaft \u0111\u1ea7u file b\u1eb1ng m\u1ed9t chu\u1ed7i k\u00fd t\u1ef1 \u0111a d\u00f2ng (triple quotes). Ph\u1ea7n n\u00e0y c\u1ef1c k\u1ef3 quan tr\u1ecdng v\u00ec khi ng\u01b0\u1eddi d\u00f9ng g\u1ecdi l\u1ec7nh help(package_name), Python s\u1ebd hi\u1ec3n th\u1ecb n\u1ed9i dung m\u00f4 t\u1ea3 n\u00e0y. Docstring gi\u00fap l\u1eadp tr\u00ecnh vi\u00ean kh\u00e1c hi\u1ec3u nhanh m\u1ee5c \u0111\u00edch c\u1ee7a package m\u00e0 kh\u00f4ng c\u1ea7n \u0111\u1ecdc to\u00e0n b\u1ed9 m\u00e3 ngu\u1ed3n.<\/p>\n\n\n\n
    Dunder Variables (Bi\u1ebfn h\u1ec7 th\u1ed1ng):<\/span><\/strong><\/p>\n\n\n\n
    Vi\u1ec7c khai b\u00e1o __version__ ngay trong __init__.py l\u00e0 m\u1ed9t quy t\u1eafc b\u1ea5t th\u00e0nh v\u0103n (convention). H\u00e0nh \u0111\u1ed9ng n\u00e0y cho ph\u00e9p ng\u01b0\u1eddi d\u00f9ng ki\u1ec3m tra phi\u00ean b\u1ea3n th\u01b0 vi\u1ec7n \u0111ang c\u00e0i \u0111\u1eb7t b\u1eb1ng l\u1ec7nh print(package.__version__), h\u1ed7 tr\u1ee3 \u0111\u1eafc l\u1ef1c cho vi\u1ec7c debug v\u00e0 qu\u1ea3n l\u00fd s\u1ef1 ph\u1ee5 thu\u1ed9c.<\/p>\n\n\n\n
    Relative Imports (Import t\u01b0\u01a1ng \u0111\u1ed1i):<\/span><\/strong><\/p>\n\n\n\n
    \u0110\u1ec3 “l\u00e0m ph\u1eb3ng” c\u1ea5u tr\u00fac g\u00f3i, l\u1eadp tr\u00ecnh vi\u00ean s\u1eed d\u1ee5ng c\u00fa ph\u00e1p from .module import Class. D\u1ea5u ch\u1ea5m . \u0111\u1ea1i di\u1ec7n cho th\u01b0 m\u1ee5c hi\u1ec7n t\u1ea1i. C\u00e1ch vi\u1ebft n\u00e0y gi\u00fap m\u00e3 ngu\u1ed3n linh ho\u1ea1t h\u01a1n; n\u1ebfu t\u00ean th\u01b0 m\u1ee5c cha thay \u0111\u1ed5i, c\u00e1c l\u1ec7nh import b\u00ean trong __init__.py v\u1eabn ho\u1ea1t \u0111\u1ed9ng ch\u00ednh x\u00e1c m\u00e0 kh\u00f4ng c\u1ea7n s\u1eeda \u0111\u1ed5i.<\/p>\n\n\n\n
    Bi\u1ebfn __all__:<\/span><\/strong><\/p>\n\n\n\n
    \u0110\u00e2y l\u00e0 “b\u1ee9c t\u01b0\u1eddng l\u1eeda” cu\u1ed1i c\u00f9ng. Danh s\u00e1ch n\u00e0y x\u00e1c \u0111\u1ecbnh giao di\u1ec7n c\u00f4ng khai (Public API) c\u1ee7a package. N\u1ebfu thi\u1ebfu __all__, l\u1ec7nh from package import * s\u1ebd kh\u00f4ng import c\u00e1c submodule m\u1ed9t c\u00e1ch t\u1ef1 \u0111\u1ed9ng (tr\u1eeb khi m\u00e3 l\u1ec7nh import \u0111\u00e3 \u0111\u01b0\u1ee3c ch\u1ea1y). Vi\u1ec7c khai b\u00e1o minh b\u1ea1ch danh s\u00e1ch n\u00e0y gi\u00fap IDE g\u1ee3i \u00fd code (autocomplete) ch\u00ednh x\u00e1c h\u01a1n v\u00e0 ng\u0103n ch\u1eb7n vi\u1ec7c l\u1ed9 c\u00e1c h\u00e0m n\u1ed9i b\u1ed9 kh\u00f4ng mong mu\u1ed1n.<\/p>\n\n\n\n
    <\/a>4 vai tr\u00f2 ch\u1ee7 \u0111\u1ea1o c\u1ee7a file __init__.py trong Python<\/strong><\/h3>\n\n\n\n
    <\/a>\u0110\u00e1nh d\u1ea5u v\u00e0 \u0111\u1ecbnh danh Python Package<\/h4>\n\n\n\n
    <\/p>\n\n\n\n
    Trong c\u00e1c phi\u00ean b\u1ea3n Python c\u0169 (tr\u01b0\u1edbc 3.3), s\u1ef1 hi\u1ec7n di\u1ec7n c\u1ee7a __init__.py l\u00e0 \u0111i\u1ec1u ki\u1ec7n b\u1eaft bu\u1ed9c \u0111\u1ec3 tr\u00ecnh th\u00f4ng d\u1ecbch nh\u1eadn di\u1ec7n m\u1ed9t th\u01b0 m\u1ee5c l\u00e0 m\u1ed9t g\u00f3i (package) c\u00f3 th\u1ec3 import \u0111\u01b0\u1ee3c. M\u1eb7c d\u00f9 Python hi\u1ec7n \u0111\u1ea1i \u0111\u00e3 gi\u1edbi thi\u1ec7u kh\u00e1i ni\u1ec7m “Implicit Namespace Package” (cho ph\u00e9p b\u1ecf qua t\u1eadp tin n\u00e0y), nh\u01b0ng vi\u1ec7c t\u1ea1o __init__.py v\u1eabn l\u00e0 ti\u00eau chu\u1ea9n v\u00e0ng (Best Practice) \u0111\u1ec3 \u0111\u1ecbnh ngh\u0129a m\u1ed9t “Regular Package”.<\/p>\n\n\n\n
    H\u00e0nh \u0111\u1ed9ng n\u00e0y gi\u00fap ph\u00e2n bi\u1ec7t r\u00f5 r\u00e0ng gi\u1eefa c\u00e1c th\u01b0 m\u1ee5c ch\u1ee9a m\u00e3 ngu\u1ed3n \u1ee9ng d\u1ee5ng v\u00e0 c\u00e1c th\u01b0 m\u1ee5c t\u00e0i nguy\u00ean th\u00f4ng th\u01b0\u1eddng (nh\u01b0 h\u00ecnh \u1ea3nh, log, cache), \u0111\u1ea3m b\u1ea3o tr\u00ecnh th\u00f4ng d\u1ecbch kh\u00f4ng l\u00e3ng ph\u00ed t\u00e0i nguy\u00ean qu\u00e9t qua c\u00e1c th\u01b0 m\u1ee5c kh\u00f4ng c\u1ea7n thi\u1ebft.<\/p>\n\n\n\n
    <\/a>Thi\u1ebft l\u1eadp v\u00e0 kh\u1edfi t\u1ea1o m\u00f4i tr\u01b0\u1eddng t\u1ef1 \u0111\u1ed9ng<\/h4>\n\n\n\n
    <\/p>\n\n\n\n
    Ngay khi m\u1ed9t package \u0111\u01b0\u1ee3c import l\u1ea7n \u0111\u1ea7u ti\u00ean v\u00e0o ch\u01b0\u01a1ng tr\u00ecnh, to\u00e0n b\u1ed9 m\u00e3 l\u1ec7nh n\u1eb1m trong __init__.py s\u1ebd \u0111\u01b0\u1ee3c th\u1ef1c thi t\u1ef1 \u0111\u1ed9ng. C\u01a1 ch\u1ebf n\u00e0y cho ph\u00e9p l\u1eadp tr\u00ecnh vi\u00ean th\u1ef1c hi\u1ec7n c\u00e1c t\u00e1c v\u1ee5 kh\u1edfi t\u1ea1o quan tr\u1ecdng tr\u01b0\u1edbc khi b\u1ea5t k\u1ef3 module con n\u00e0o \u0111\u01b0\u1ee3c s\u1eed d\u1ee5ng, bao g\u1ed3m:<\/p>\n\n\n\n