# pythonLearn

**Repository Path**: dengdairiluo/pythonLearn

## Basic Information

- **Project Name**: pythonLearn
- **Description**: python自学
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-08
- **Last Updated**: 2026-02-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# pythonLearn

Python 自学项目

## 项目简介

这是一个 Python 学习项目，用于记录和学习 Python 编程知识。项目目前处于初始化阶段，欢迎补充和贡献内容。

## 项目目标

- 学习 Python 基础语法和核心概念
- 掌握 Python 标准库的使用
- 了解 Python 生态系统和常用框架
- 实践项目开发和最佳实践

## 项目结构

```
pythonLearn/
├── src/                    # 源代码目录（待创建）
├── tests/                  # 测试目录（待创建）
├── docs/                   # 文档目录（待创建）
├── requirements.txt        # 依赖列表（待创建）
├── pyproject.toml          # 项目配置（待创建）
├── README.md               # 中文说明文档
├── README.en.md            # 英文说明文档
├── AGENTS.md               # 智能代理开发指南
└── LICENSE                 # Apache License 2.0
```

## 开发环境

### 环境要求

- Python 3.8+
- Git

### 推荐工具

- **测试**: pytest
- **代码格式化**: Black
- **导入排序**: isort
- **代码检查**: flake8
- **类型检查**: mypy

## 快速开始

### 克隆项目

```bash
git clone https://github.com/your-username/pythonLearn.git
cd pythonLearn
```

### 创建虚拟环境（推荐）

```bash
# 使用 venv
python -m venv venv
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate     # Windows
```

### 安装依赖

```bash
# 创建 requirements.txt 后
pip install -r requirements.txt
```

## 代码规范

本项目遵循 PEP 8 编码规范，并采用以下约定：

- **语言**: 所有注释和文档使用中文
- **命名**:
  - 函数和变量: snake_case
  - 类: PascalCase
  - 常量: UPPER_CASE
- **文档字符串**: 所有函数必须包含中文 docstring
- **类型注解**: 建议为函数添加类型注解

详细信息请参考 [AGENTS.md](AGENTS.md)

## 学习资源

### 官方文档

- [Python 官方文档](https://docs.python.org/zh-cn/3/)
- [PEP 8 - 风格指南](https://peps.python.org/pep-0008/)

### 推荐教程

- [Python 教程 - 廖雪峰](https://www.liaoxuefeng.com/wiki/1016959663602400)
- [Real Python](https://realpython.com/)

## 贡献指南

欢迎贡献代码、文档或提出建议！

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/xxx`)
3. 提交更改 (`git commit -m 'Add some feature'`)
4. 推送到分支 (`git push origin feature/xxx`)
5. 创建 Pull Request

### 贡献要求

- 代码必须遵循项目规范
- 添加必要的注释和文档
- 为新功能编写测试
- 确保所有测试通过

## 许可证

本项目采用 [Apache License 2.0](LICENSE) 许可证。

## 联系方式

如有问题或建议，欢迎通过 Issue 或 Pull Request 联系。

---

**最后更新**: 2026年2月8日