Это можно сделать, предоставив собственный HelpFormatter класс; внутренности которого официально не задокументированы. Это означает, что вы сами по себе, когда дело доходит до совместимости от версии к версии Python, но я считаю интерфейс довольно стабильным:

from argparse import HelpFormatter
from operator import attrgetter

class SortingHelpFormatter(HelpFormatter):
    def add_arguments(self, actions):
        actions = sorted(actions, key=attrgetter('option_strings'))
        super(SortingHelpFormatter, self).add_arguments(actions)


p = argparse.ArgumentParser(...
    formatter_class=SortingHelpFormatter,
)

Здесь я сортирую по строкам опций (('--dur', '-d') и т. д.), но вы можете сами выбрать, по чему сортировать. Этот простой параметр сортировки ставит варианты с одним тире последними, например параметр -h.

который выводит:

usage: [-h] [--first FIRST] [--dur DUR] [--title TITLE] [--interp]

Load duration curves and other plots

optional arguments:
  --dur DUR, -d DUR     Duration in Hours. Use -1 for all
  --first FIRST, -f FIRST
                        First Hour
  --interp, -i          Use linear interpolation for smoother curves
  --title TITLE, -t TITLE
                        Plot Title (for all plots), default=file name
  -h, --help            show this help message and exit

При создании класса ArgumentParser вы можете передать средство форматирования справки: http://docs.python.org/library/argparse.html#formatter-class

Таким образом, очевидно, вы можете использовать один из поставляемых форматтеров, но не можете переопределить и заменить их без реверс-инжиниринга:

>>> h = argparse.ArgumentDefaultsHelpFormatter
>>> print h.__doc__
Help message formatter which adds default values to argument help.

    Only the name of this class is considered a public API. All the methods
    provided by the class are considered an implementation detail.

Альтернативный, определенно более уродливый способ сделать это, чем предложенный @MartijnPieters:

p = argparse.ArgumentParser()

#add arguements here

for g in p._action_groups:
    g._group_actions.sort(key=lambda x:x.dest)

Может быть, было бы неплохо поместить это в предложение try/except, так как это только помощь в форматировании, поэтому для выполнения программы не должно иметь большого значения, если этот фрагмент кода не работает на AttributeError или что-то в этом роде...

Это похоже на ответ @mgilson. Я думал, что уже публиковал это раньше, но, видимо, нет.

d = dict()
d['--first'] = ('-f', "type=int", "default=1", "help='First Hour'")
d['--dur'] = ('-d', type=int, default=-1, help='Duration in Hours. Use -1 for all')
# etc

for prim_option in sorted(d):
    p.add_arguments(prim_option, *d[prim_option])

Вы можете настроить то, что именно используется в качестве ключа в словаре, а также аргументы sorted и точную структуру вызова add_arguments, чтобы получить желаемый порядок сортировки. Это соответствует общедоступному документированному интерфейсу argparse, но добавляет слой к процессу определения вашего синтаксического анализатора. (В зависимости от вашей философии такое отделение информации об опциях от реализации парсера может быть полезным.)

Порядок аргументов в справке определяется методом parser.format_help:

Definition:  parser.format_help(self)
Source:
    def format_help(self):
        formatter = self._get_formatter()
        ...
        # positionals, optionals and user-defined groups
        for action_group in self._action_groups:
            formatter.start_section(action_group.title)
            formatter.add_text(action_group.description)
            formatter.add_arguments(action_group._group_actions)
            formatter.end_section()

help создается путем извлечения объекта formatter и последующего добавления к нему «разделов». Здесь он перебирает _action_groups, помещая каждый в свой раздел и добавляя свои действия (аргументы) с помощью метода add_arguments. Средство форматирования является временным и существует только для создания строк (обычно нескольких строк).

Группы действий включают стандартные postionals и optionals, а также все, что создает пользователь. Эти группы используются только для справки, а не для синтаксического анализа. Таким образом, список action_group._group_actions можно было переупорядочить, не влияя на синтаксический анализ. (парсер имеет свой список действий, parser._actions).

Это подтверждает наблюдение @mgilson о том, что сортировка p._actions не влияет на справку, а сортировка _group_actions влияет.

Сортировка _actions повлияет на usage (будь то часть справки или отдельно):

    # usage
    formatter.add_usage(self.usage, self._actions,
                        self._mutually_exclusive_groups)

Обратите внимание, что action_groups не передаются в раздел использования. Раздел использования меняет порядок своих действий, отображая сначала optionals, затем positionals.

Сортируйте аргументы до/во время этапа add_argument, если вы хотите контролировать порядок синтаксического анализа позиционных выражений и их порядок в использовании.

Если вы просто хотите контролировать порядок в группах помощи, не стесняйтесь переупорядочивать элементы в списке ._group_actions либо перед вызовом средства форматирования, либо внутри него.

Были и другие вопросы SO об управлении порядком действий в файле usage. Некоторые, например, не хотят, чтобы positionals располагалось после optionals.

Я согласен, что класс Formatter громоздок. Но по большей части он отделен от класса Parser. Таким образом, его можно было бы переписать с минимальным влиянием на синтаксический анализ. Существующие подклассы Formatter просто настраивают низкоуровневые методы, которые управляют переносом строк и форматированием строк справки. Важным интерфейсом между синтаксическим анализатором и средством форматирования являются методы format_usage и format_help, которые являются относительно более простыми и высокоуровневыми.

подклассы

Несмотря на предупреждение, которое цитирует @grieve, люди создают подклассы HelpFormatter в соответствии со своими потребностями. Единственное, что удерживает людей от этого, — это какая-то политика компании. Все предупреждение говорит нам о том, что разработчики argparse не пытались представить или задокументировать все изменения, которые пользователи могут захотеть внести. Я даже не смог перечислить те, которые я предложил за последние несколько лет.