> For the complete documentation index, see [llms.txt](https://icity.gitbook.io/python/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://icity.gitbook.io/python/codespecification_preface/codespecification_third.md).
# 命å规范
## 1ã€æ¨¡å—
* 模å—å°½é‡ä½¿ç”¨å°å†™å‘½å，首å—æ¯ä¿æŒå°å†™ï¼Œå°½é‡ä¸è¦ç”¨ä¸‹åˆ’线(除éžå¤šä¸ªå•è¯ï¼Œä¸”æ•°é‡ä¸å¤šçš„情况)
```python
# æ£ç¡®çš„模å—å
import decoder
import html_parser
# ä¸æŽ¨è的模å—å
import Decoder
```
## 2ã€ç±»å
* ç±»å使用驼峰(CamelCase)命åé£Žæ ¼ï¼Œé¦–å—æ¯å¤§å†™ï¼Œç§æœ‰ç±»å¯ç”¨ä¸€ä¸ªä¸‹åˆ’线开头
```python
class Farm():
pass
class AnimalFarm(Farm):
pass
class _PrivateFarm(Farm):
pass
```
* 将相关的类和顶级函数放在åŒä¸€ä¸ªæ¨¡å—里. ä¸åƒJava, 没必è¦é™åˆ¶ä¸€ä¸ªç±»ä¸€ä¸ªæ¨¡å—.
## 3ã€å‡½æ•°
* 函数å一律å°å†™ï¼Œå¦‚有多个å•è¯ï¼Œç”¨ä¸‹åˆ’线隔开
```python
def run():
pass
def run_with_env():
pass
```
* ç§æœ‰å‡½æ•°åœ¨å‡½æ•°å‰åŠ 一个下划线\_
```python
class Person():
def _private_func():
pass
```
## 4ã€å˜é‡å
* å˜é‡åå°½é‡å°å†™, 如有多个å•è¯ï¼Œç”¨ä¸‹åˆ’线隔开
```python
if __name__ == '__main__':
count = 0
school_name = ''
```
* 常é‡é‡‡ç”¨å…¨å¤§å†™ï¼Œå¦‚有多个å•è¯ï¼Œä½¿ç”¨ä¸‹åˆ’线隔开
```python
MAX_CLIENT = 100
MAX_CONNECTION = 1000
CONNECTION_TIMEOUT = 600
```
## 5ã€å¸¸é‡
* 常é‡ä½¿ç”¨ä»¥ä¸‹åˆ’线分隔的大写命å
```python
MAX_OVERFLOW = 100
Class FooBar:
def foo_bar(self, print_):
print(print_)
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://icity.gitbook.io/python/codespecification_preface/codespecification_third.md?ask=