Every project starts the same way…
You hardcode a few values, sprinkle some os.getenv() calls, and tell yourself “I’ll clean this up later.”
Later never comes.
Instead, just do this 👇
Install package:
pip install pydantic-settings
config.py
from pydantic_settings import BaseSettings
class Settings(BaseSettings):
APP_ENV: str = "development"
APP_TITLE: str = "App Title"
APP_VERSION: str = "1.0.0"
FRONTEND_URL: str = "http://localhost:5173"
SECRET_KEY: str
CORS_ORIGINS: list[str] = []
class Config:
env_file = ".env"
env_file_encoding = "utf-8"
case_sensitive = True
extra = "ignore"
settings = Settings()
Enter fullscreen mode
Exit fullscreen mode
Why This Is Actually Nice
You get defaults, so your app runs instantly
You get env overrides, so prod doesn’t break
You get type safety, no weird bugs later
How You Use It
import config.settings
print(settings.APP_ENV)
Enter fullscreen mode
Exit fullscreen mode
Boom. Done.
Create template
Templates let you quickly answer FAQs or store snippets for re-use.
Submit
Preview
Dismiss
Are you sure you want to hide this comment? It will become hidden in your post, but will still be visible via the comment's permalink.
Hide child comments as well
Confirm
For further actions, you may consider blocking this person and/or reporting abuse

Mọi dự án phần mềm thường đều bắt đầu theo một quy trình khá giống nhau. Bạn viết cứng (hardcode) một vài giá trị, rải rác các cuộc gọi `os.getenv()` trong mã nguồn, và tự nhủ với bản thân: *"Mình sẽ dọn dẹp việc này sau."*

Nhưng "sau đó" thực sự chẳng bao giờ đến.

Thay vì tiếp tục cách làm thủ công đó, hãy thử áp dụng giải pháp dưới đây ngay lập tức.

## Cài đặt thư viện

Đầu tiên, bạn cần cài đặt gói `pydantic-settings` thông qua pip:

```bash
pip install pydantic-settings
```

## Thiết lập file config.py

Dưới đây là cách triển khai một file `config.py` chuẩn và gọn gàng sử dụng Pydantic:

```python
from pydantic_settings import BaseSettings

class Settings(BaseSettings):
    APP_ENV: str = "development"
    APP_TITLE: str = "App Title"
    APP_VERSION: str = "1.0.0"
    FRONTEND_URL: str = "http://localhost:5173"
    SECRET_KEY: str
    CORS_ORIGINS: list[str] = []

    class Config:
        env_file = ".env"
        env_file_encoding = "utf-8"
        case_sensitive = True
        extra = "ignore"


settings = Settings()
```

## Tại sao cách tiếp cận này lại hiệu quả?

Phương pháp này mang lại ba lợi ích chính cho nhà phát triển:

*   **Giá trị mặc định (Defaults):** Ứng dụng của bạn có thể chạy ngay lập tức mà không cần cấu hình phức tạp từ đầu.
*   **Ghi đè từ biến môi trường (Env overrides):** Bạn có thể dễ dàng thay đổi cấu hình khi triển khai (deploy) lên môi trường production mà không sợ làm gãy ứng dụng.
*   **An toàn kiểu dữ liệu (Type safety):** Nhờ có định nghĩa kiểu (type hints), bạn sẽ tránh được những lỗi bug khó chịu do dữ liệu không đúng định dạng gây ra trong tương lai.

## Cách sử dụng trong dự án

Để sử dụng cấu hình đã thiết lập, bạn chỉ cần nhập module và gọi đối tượng `settings`:

```python
import config.settings

print(settings.APP_ENV)
```

Xong. Đơn giản và chuyên nghiệp.

Every project starts the same way… 
You hardcode a few values, sprinkle some <code>os.getenv()</code> calls, and tell yourself “I’ll clean this up later.”

Later never comes.

Instead, just do this 👇

Install package: 
<code>pip install pydantic-settings</code>

<code>config.py</code> 


<div class="highlight js-code-highlight">
<pre class="highlight python"><code>from pydantic_settings import BaseSettings

class Settings(BaseSettings):
 APP_ENV: str = "development"
 APP_TITLE: str = "App Title"
 APP_VERSION: str = "1.0.0"
 FRONTEND_URL: str = "http://localhost:5173"
 SECRET_KEY: str
 CORS_ORIGINS: list[str] = []

 class Config:
 env_file = ".env"
 env_file_encoding = "utf-8"
 case_sensitive = True
 extra = "ignore"


settings = Settings()
</code></pre>

</div>



<h2>
 
 
 Why This Is Actually Nice
</h2>

<ul>
<li>You get defaults, so your app runs instantly</li>
<li>You get env overrides, so prod doesn’t break</li>
<li>You get type safety, no weird bugs later</li>
</ul>

<h2>
 
 
 How You Use It
</h2>



<div class="highlight js-code-highlight">
<pre class="highlight python"><code>import config.settings

print(settings.APP_ENV)
</code></pre>

</div>



Boom. Done.

Thay vì viết cứng giá trị hay sử dụng lặp lại các lệnh `os.getenv()`, hãy tìm hiểu cách dùng thư viện `pydantic-settings` để quản lý file `config.py` tối ưu hơn. Cách tiếp cận này cung cấp tính năng type safety, giá trị mặc định và khả năng ghi đè linh hoạt cho môi trường sản xuất.

Quản lý cấu hình dự án Python chuyên nghiệp với Pydantic Settings

Cài đặt thư viện

Thiết lập file config.py

Tại sao cách tiếp cận này lại hiệu quả?

Cách sử dụng trong dự án

Bài viết liên quan