autopep8 命令

常用示例

说明

autopep8 automatically formats Python code to conform to the PEP 8 style guide. It fixes issues like whitespace, indentation, and line length while preserving code semantics. The tool integrates with editors and CI pipelines to enforce consistent Python style. It uses pycodestyle to detect style violations and applies fixes accordingly.

参数

-i, --in-place

Modify files in place.

-d, --diff

Print the unified diff of changes instead of modifying the file.

-r, --recursive

Process directories recursively. Requires `--in-place` or `--diff`.

-a, --aggressive

Enable more aggressive fixes beyond whitespace. Repeatable for increasing aggressiveness (e.g., -aa).

-j _n_, --jobs _n_

Number of parallel jobs. Values less than 1 use all available CPUs.

--select _errors_

Fix only the specified error codes (e.g., E501,W293).

--ignore _errors_

Ignore the specified error codes (default: E226,E24,W50,W690).

--max-line-length _n_

Maximum allowed line length (default: 79).

--range _start_ _end_

Only fix errors on lines within the specified range.

--exclude _patterns_

Exclude files and directories matching the specified comma-separated glob patterns.

--experimental

Enable experimental code-shortening features.

--list-fixes

List available error codes that can be used with `--select` and `--ignore`.

-v, --verbose

Print verbose messages. Can be repeated for more verbosity.

-p _n_, --pep8-passes _n_

Maximum number of additional formatting passes (default: infinite until no more changes).

--hang-closing

Hang the closing bracket instead of matching indentation of the opening line.

--exit-code

Return exit code 2 when changes were made with `--diff` or `--in-place`.

--global-config _filename_

Specify a custom global configuration file for pycodestyle rules.

--ignore-local-config

Skip reading local configuration files.

--version

Show version number and exit.

--help

Display help information.