2.7 KiB
2.7 KiB
贡献指南
感谢你对本项目的兴趣!我们欢迎任何形式的贡献,无论是报告 bug、提交功能请求、改进文档,还是直接提交代码。为了使贡献过程更加顺利,请按照以下指南进行操作。
如何开始
- Fork 项目:首先将项目
Fork到你的GitHub账户。 - 克隆到本地:将你
Fork后的仓库克隆到本地。git clone https://github.com/你的用户名/uniapp-vue3-template.git - 创建分支:在进行任何修改之前,先创建一个新的分支。
git checkout -b feature/your-feature-name - 进行修改:根据你的需求进行代码修改或文档编辑。
- 提交更改:完成修改后,使用以下命令提交更改:
pnpm cz - 推送分支:将你的分支推送到 GitHub。
git push origin feature/your-feature-name - 创建 Pull Request:在
GitHub上,提交你的Pull Request,描述清楚你所做的更改。
提交代码规范
- 代码格式:只要你安装了依赖项,就不用担心代码风格。
Git钩子会在提交时为你格式化和修复它们。 - 简洁明了的提交信息:提交信息应简明扼要,说明改动的目的和内容。建议使用以下格式:
例如:
[类型]:简要说明feat: 添加新功能 fix: 修复 bug docs: 更新文档 style: 格式调整 perf: 性能优化 refactor: 代码重构 test: 添加/修改测试 ci: 持续集成、工作流 revert: 撤销更改 chore: 其他修改(更新依赖、修改配置等)
贡献前请注意
- 讨论功能请求:在提交功能请求之前,确保这个功能是项目当前的方向。
- 修复 bug:在修复
bug之前,先检查现有的issue列表,看看是否有人已经报告了相同的问题。 - 文档改进:欢迎任何形式的文档改进。文档有时会被遗漏,但它对于项目的可用性至关重要。
测试
在提交 Pull Request 之前,请确保测试成功通过。如果有修改涉及到核心功能,请确保你的改动不会破坏现有的功能。
行为规范
希望在这个项目中创建一个友好和包容的社区。请遵循以下行为准则:
- 尊重他人,避免人身攻击、歧视或骚扰。
- 提供有建设性的反馈,不论是代码还是讨论。
- 对不同的观点保持开放的态度,愿意倾听他人的建议。
相关文档
感谢你的贡献!期待与你的合作!