随着github成为了全球领先的代码托管平台, 越来越多的人将项目托管在github上。然而, 在使用github时难免会遇到一些问题，例如您可能遇到了某个bug，或者您不确定如何使用某个功能。这时，您需要提一个issue来寻求帮助。那么，如何正确地提出一个issue呢？本文将详细介绍github如何提issue。
什么是Github Issue?
在Github上, issue是指某项任务目标的问题/错误/建议等描述。多数情况下, issue 相当于bug报告，其目的是为了让项目开发者了解您在使用项目中遇到的问题。Github提供了一种结构化的方式让用户提交问题，这也是众多开源项目管理中的重要环节。
准备提交Issue前需要准备什么？
在提交issue之前，您需要进行以下准备工作:
- 搜寻是否已经有人提交了同样的issue: 在Github页面上，可以通过"Search issue"、"Labels"、"Projects"等选项查看是否已经有人提出了同样的issue。
- 具体指明问题: 确定一个具体的问题,理清楚目前的情况和出现问题的原因,并尝试提出可能的解决方案。
- 区分错误和建议: "issue"代表了一些技术问题，诸如Bug、错误或者缺陷，而"feature request"或申请新功能就是在Github上提出新功能性需求或者改进建议。
- 选定一个合适的Repository:在Github上不同的Repository有不同的功能和目的，因此需要选定一个相应的Repository来提交issue。
如何正确的提交 issue
- 登陆Github帐号: 在提交issue前, 首先需要登录您的Github账号。
- 找到正确的Repository并选择它：通过搜索或直接输入URL找到正确的Repository，并进入相应的页面。
- 点击"New issue"按钮：该按钮在Repository页面的右侧，点击这个按钮即可进入新的issue提交页面。
- 写标题和正文："Title" 是issue的标题，它应该简短明了描述您的问题。在正文部分，建议您提供更加详细的信息，以便让开发者更清楚地了解您的问题以及出现问题的背景。提供截图、代码片段、日志文件等信息是很有帮助的。
- 给issue选择标签：为了让其他开发者更容易理解您的issue，需要给issue选择与之相关的标签。Github提供了大量的标签，在界面的右侧可以找到相关的选项。
- 给issue分配到对应的负责人：如果确定某个开发者对这个issue具有较高的专业性，则可以指定这个开发者来负责解决此问题。
- 点击"Submit new issue"按钮: 如果一切都准备就绪，点击"Submit new issue"按钮即可提交您的issue。
总结
在使用Github时, issue的提交是避免和解决问题的重要手段之一。正确的提交issue,不仅可以帮助您及时解决问题，也可以帮助项目开发人员迅速定位和解决问题。希望上述介绍对您在使用Github时提issue提供一些帮助。
