# 贡献指南

感谢你对 MockAddress Core 项目的关注！我们欢迎任何形式的贡献，包括但不限于：

- 报告 Bug
- 提出功能建议
- 提交代码改进（Pull Request）
- 改进文档

## 如何贡献

### 报告问题

如果你发现了 Bug 或有功能建议，请通过 GitHub Issues 提交。提交前请先搜索是否已有类似问题。

提交 Issue 时，请尽量包含：
- 问题描述
- 复现步骤（如果是 Bug）
- 预期行为与实际行为
- 环境信息（浏览器、操作系统等）

### 提交代码

1. Fork 本仓库
2. 创建你的特性分支（`git checkout -b feature/AmazingFeature`）
3. 提交你的更改（`git commit -m 'Add some AmazingFeature'`）
4. 推送到分支（`git push origin feature/AmazingFeature`）
5. 开启一个 Pull Request

### 代码规范

- 保持代码风格与现有代码一致
- 添加必要的注释，特别是复杂逻辑
- 确保你的更改不会破坏现有功能
- 如果可能，添加或更新相关测试

### 文档改进

文档改进同样欢迎！如果你发现 README 或其他文档有不清楚或错误的地方，欢迎提交 PR。

## 行为准则

- 保持友好和尊重
- 欢迎不同观点和经验
- 优雅地接受建设性批评
- 关注对社区最有利的事情

感谢你的贡献！