Quickstart for GitHub Code Quality

Review code quality findings, generate a 코파일럿 자동 수정, and merge a pull request to improve reliability and maintainability with GitHub Code Quality.

누가 이 기능을 사용할 수 있나요?

쓰기 권한이 있는 사용자

GitHub Code Quality은 조직 소유의 리포지토리에서 GitHub Team 또는 GitHub Enterprise Cloud에서 사용 가능합니다.

이 문서의 내용

Introduction

GitHub Code Quality (공개 미리 보기) helps keep your code reliable and maintainable by surfacing code quality findings in pull requests and on your default branch.

In this tutorial, you’ll learn how to identify and fix a code quality finding on your default branch, helping to improve your repository’s code health.

Prerequisites

  • GitHub Code Quality must be enabled for your repository and you must have code in a supported language. See GitHub Code Quality 활성화.
  • If you're enabling GitHub Code Quality for the first time, ensure you've waited a few minutes after enablement for a full CodeQL scan of the default branch to complete.

Review scan results for your default branch

In your repository, go to the Security tab, click 코드 품질 in the left sidebar, then click 표준 결과 to open the repository dashboard.

Here you'll see:

  • Ratings for the Reliability and Maintainability of your codebase, which help you understand your code health at a glance.

  • A results list of all the quality issues detected by a CodeQL-powered analysis on your default branch, which are grouped by rule and language.

    Screenshot of code quality ratings in the "표준 결과" view for Code Quality.

Identify a high-impact finding

Use the dashboard filters to identify a high severity level finding ("Error" or "Warning").

Resolving these will have the biggest impact on your repository's ratings.

Screenshot showing the dashboard filters for the "표준 결과" view.

Inspect the details of the finding

Click the rule name itself to see a detailed view of the files and lines of code affected by that rule.

Screenshot showing a rule in the "표준 결과" view. The rule name is highlighted in dark orange.

Once you're in the detailed view, click Show more to gather context and understand the results.

Screenshot of the findings for the "Overwritten property" rule. The text, "Show more", is highlighted in dark orange.

Generate a 코파일럿 자동 수정

To the right of a highlighted finding, click Generate fix.

Screenshot of the "Generate fix" button.

Review the suggested fix, then click Open pull request.

Merge the fix

Carefully review the draft pull request. If you're satisfied with the proposed changes, and all checks and tests are passing, go ahead and merge the pull request.

Observe the metrics change

Return to the Code Quality dashboard (Security tab, then 코드 품질, then 표준 결과).

Wait a few minutes for the next scan to complete — Code Quality scans automatically re-run after every push to the default branch.

Observe the change in metrics at the top of the dashboard:

  • The number of findings for "Reliability" or "Maintainability" should have decreased.

  • Your ratings for "Reliability" or "Maintainability" may have improved, if your fix addressed a number of high-impact findings.

    To understand more about how the ratings are calculated, see Metrics and ratings reference.

Conclusion

You've successfully used Code Quality and 코파일럿 자동 수정 to improve your repository's code health!

Healthy code is easier to understand, maintain, and extend, and remediating code quality issues makes your codebase more reliable, compliant, and accelerates future development.

Next steps