# error: option --install-lib not recognized
usage: setup.py [global_opts] cmd1 [cmd1_opts] [cmd2 [cmd2_opts] ...]
or: setup.py --help [cmd1 cmd2 ...]
or: setup.py --help-commands
or: setup.py cmd --help

- **ID:** `python/setuptools-unknown-distribution-option`
- **Domain:** python
- **Category:** config_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

A custom distutils/setuptools command is invoked with an option it does not declare in user_options, so the option parser rejects it.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| 3.x | active | — | — |

## Workarounds

1. **** (95% success)
   ```
   In the Command subclass, add user_options = [('install-lib=', None, 'target directory')] and handle it in initialize_options/finalize_options.
   ```
2. **** (90% success)
   ```
   Move the setting into setup.cfg under [install] install-lib = /path and run python setup.py install.
   ```

## Dead Ends

- **** — The command still does not declare the option; order does not matter. (90% fail)
- **** — Verbosity does not register unknown options. (95% fail)
- **** — Privilege is unrelated to option parsing. (95% fail)