このコンテンツは選択した言語では利用できません。

Chapter 3. gofmt


gofmt is a code formatting tool for the Go programming language, packaged together with the go compiler.

Go Toolset is distributed with gofmt 1.11.5.

3.1. Installing gofmt

In Go Toolset, gofmt is provided by the go-toolset-1.11-golang package and is automatically installed with the go-toolset-1.11 package. See Section 1.4, “Installing Go Toolset”.

3.2. Formatting Code

To format all code in the code_path path, run the gofmt tool as follows:

  • For Red Hat Enterprise Linux 7:

    $ scl enable go-toolset-1.11 'gofmt -w code_path'
  • For Red Hat Enterprise Linux 8:

    $ gofmt -w code_path

This command will directly change code in the code_path path. When code_path is a single file, the changes apply only to the file. When code_path is a directory, all .go files in the directory are processed.

When the code_path is omitted, gofmt reads standard input instead.

To print the formatted code to standard output instead of writing to the original file, omit the -w option.

It is possible to invoke gofmt through the go compiler with the fmt command. To achieve the same results as the command above, run:

  • For Red Hat Enterprise Linux 7:

    $ scl enable go-toolset-1.11 'gofmt -l -w -s code_path'
  • For Red Hat Enterprise Linux 8:

    $ gofmt -l -w -s code_path

3.3. Previewing Changes to Code

To preview changes done by formatting code in a given path code_path, run the gofmt tool with the -d option as follows:

  • For Red Hat Enterprise Linux 7:

    $ scl enable go-toolset-1.11 'gofmt -d code_path'
  • For Red Hat Enterprise Linux 8:

    $ gofmt -d code_path

The output in unified diff format is printed to standard output.

It is possible to combine both the -d and -w options.

3.4. Simplifying Code

To simplify code in a given path code_path, run the gofmt tool with the -s option as follows:

  • For Red Hat Enterprise Linux 7:

    $ scl enable go-toolset-1.11 'gofmt -s code_path'
  • For Red Hat Enterprise Linux 8:

    $ gofmt -s code_path

The code under code_path is simplified. Use the -d option to show the differences, and use the -w option to apply the changes to the code.

3.5. Refactoring code

The gofmt tool can be used to refactor code by applying arbitrary substitutions. To refactor code in a given path code_path according to a rule rewrite_rule, run the gofmt tool with the -r option as follows:

  • For Red Hat Enterprise Linux 7:

    $ scl enable go-toolset-1.11 'gofmt -r rewrite_rule code_path'
  • For Red Hat Enterprise Linux 8:

    $ gofmt -r rewrite_rule code_path

The code under code_path is refactored according to the rule rewrite_rule. Use the -d option to show the differences, and use the -w option to apply the changes to the code. The additional options must be placed after the rule rewrite_rule:

  • For Red Hat Enterprise Linux 7:

    $ scl enable go-toolset-1.11 'gofmt -r rewrite_rule -d code_path'
  • For Red Hat Enterprise Linux 8:

    $ gofmt -r rewrite_rule -d code_path

Detailed description of the rewrite rules is beyond the scope of this book. For more information, see the resources listed in Section 3.6, “Additional Resources”.

3.6. Additional Resources

A detailed description of the gofmt tool and its features is beyond the scope of this book. For more information, see the resources listed below.

Online Documentation

See Also

Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

© 2024 Red Hat, Inc.