cmdline.po

# Copyright (C) 2001-2024, Python Software Foundation
# This file is distributed under the same license as the Python package.
#
# Translators:
msgid ""
msgstr ""
"Project-Id-Version: Python 3.13\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-09-01 21:59+0000\n"
"PO-Revision-Date: 2018-05-23 16:19+0000\n"
"Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
"tw)\n"
"Language: zh_TW\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=1; plural=0;\n"

#: ../../using/cmdline.rst:9
msgid "Command line and environment"
msgstr "命令列與環境"

#: ../../using/cmdline.rst:11
msgid ""
"The CPython interpreter scans the command line and the environment for "
"various settings."
msgstr ""

#: ../../using/cmdline.rst:16
msgid ""
"Other implementations' command line schemes may differ.  See :ref:"
"`implementations` for further resources."
msgstr ""

#: ../../using/cmdline.rst:23
msgid "Command line"
msgstr "命令列"

#: ../../using/cmdline.rst:25
msgid "When invoking Python, you may specify any of these options::"
msgstr ""

#: ../../using/cmdline.rst:27
msgid ""
"python [-bBdEhiIOPqRsSuvVWx?] [-c command | -m module-name | script | - ] "
"[args]"
msgstr ""
"python [-bBdEhiIOPqRsSuvVWx?] [-c command | -m module-name | script | - ] "
"[args]"

#: ../../using/cmdline.rst:29
msgid ""
"The most common use case is, of course, a simple invocation of a script::"
msgstr ""

#: ../../using/cmdline.rst:31
msgid "python myscript.py"
msgstr "python myscript.py"

#: ../../using/cmdline.rst:37
msgid "Interface options"
msgstr "介面選項"

#: ../../using/cmdline.rst:39
msgid ""
"The interpreter interface resembles that of the UNIX shell, but provides "
"some additional methods of invocation:"
msgstr ""

#: ../../using/cmdline.rst:42
msgid ""
"When called with standard input connected to a tty device, it prompts for "
"commands and executes them until an EOF (an end-of-file character, you can "
"produce that with :kbd:`Ctrl-D` on UNIX or :kbd:`Ctrl-Z, Enter` on Windows) "
"is read. For more on interactive mode, see :ref:`tut-interac`."
msgstr ""

#: ../../using/cmdline.rst:46
msgid ""
"When called with a file name argument or with a file as standard input, it "
"reads and executes a script from that file."
msgstr ""

#: ../../using/cmdline.rst:48
msgid ""
"When called with a directory name argument, it reads and executes an "
"appropriately named script from that directory."
msgstr ""

#: ../../using/cmdline.rst:50
msgid ""
"When called with ``-c command``, it executes the Python statement(s) given "
"as *command*.  Here *command* may contain multiple statements separated by "
"newlines. Leading whitespace is significant in Python statements!"
msgstr ""

#: ../../using/cmdline.rst:53
msgid ""
"When called with ``-m module-name``, the given module is located on the "
"Python module path and executed as a script."
msgstr ""

#: ../../using/cmdline.rst:56
msgid ""
"In non-interactive mode, the entire input is parsed before it is executed."
msgstr ""

#: ../../using/cmdline.rst:58
msgid ""
"An interface option terminates the list of options consumed by the "
"interpreter, all consecutive arguments will end up in :data:`sys.argv` -- "
"note that the first element, subscript zero (``sys.argv[0]``), is a string "
"reflecting the program's source."
msgstr ""

#: ../../using/cmdline.rst:65
msgid ""
"Execute the Python code in *command*.  *command* can be one or more "
"statements separated by newlines, with significant leading whitespace as in "
"normal module code."
msgstr ""

#: ../../using/cmdline.rst:69
msgid ""
"If this option is given, the first element of :data:`sys.argv` will be ``\"-"
"c\"`` and the current directory will be added to the start of :data:`sys."
"path` (allowing modules in that directory to be imported as top level "
"modules)."
msgstr ""

#: ../../using/cmdline.rst:74
msgid ""
"Raises an :ref:`auditing event <auditing>` ``cpython.run_command`` with "
"argument ``command``."
msgstr ""
"引發一個附帶引數 ``command`` 的\\ :ref:`稽核事件 <auditing>` ``cpython."
"run_command``。"

#: ../../using/cmdline.rst:78
msgid ""
"Search :data:`sys.path` for the named module and execute its contents as "
"the :mod:`__main__` module."
msgstr ""

#: ../../using/cmdline.rst:81
msgid ""
"Since the argument is a *module* name, you must not give a file extension "
"(``.py``).  The module name should be a valid absolute Python module name, "
"but the implementation may not always enforce this (e.g. it may allow you to "
"use a name that includes a hyphen)."
msgstr ""

#: ../../using/cmdline.rst:86
msgid ""
"Package names (including namespace packages) are also permitted. When a "
"package name is supplied instead of a normal module, the interpreter will "
"execute ``<pkg>.__main__`` as the main module. This behaviour is "
"deliberately similar to the handling of directories and zipfiles that are "
"passed to the interpreter as the script argument."
msgstr ""

#: ../../using/cmdline.rst:95
msgid ""
"This option cannot be used with built-in modules and extension modules "
"written in C, since they do not have Python module files. However, it can "
"still be used for precompiled modules, even if the original source file is "
"not available."
msgstr ""

#: ../../using/cmdline.rst:100
msgid ""
"If this option is given, the first element of :data:`sys.argv` will be the "
"full path to the module file (while the module file is being located, the "
"first element will be set to ``\"-m\"``). As with the :option:`-c` option, "
"the current directory will be added to the start of :data:`sys.path`."
msgstr ""

#: ../../using/cmdline.rst:105
msgid ""
":option:`-I` option can  be used to run the script in isolated mode where :"
"data:`sys.path` contains neither the current directory nor the user's site-"
"packages directory. All ``PYTHON*`` environment variables are ignored, too."
msgstr ""

#: ../../using/cmdline.rst:110
msgid ""
"Many standard library modules contain code that is invoked on their "
"execution as a script.  An example is the :mod:`timeit` module::"
msgstr ""

#: ../../using/cmdline.rst:113
msgid ""
"python -m timeit -s \"setup here\" \"benchmarked code here\"\n"
"python -m timeit -h # for details"
msgstr ""

#: ../../using/cmdline.rst:116
msgid ""
"Raises an :ref:`auditing event <auditing>` ``cpython.run_module`` with "
"argument ``module-name``."
msgstr ""
"引發一個附帶引數 ``module-name`` 的\\ :ref:`稽核事件 <auditing>` ``cpython."
"run_module``。"

#: ../../using/cmdline.rst:119
msgid ":func:`runpy.run_module`"
msgstr ":func:`runpy.run_module`"

#: ../../using/cmdline.rst:120 ../../using/cmdline.rst:172
msgid "Equivalent functionality directly available to Python code"
msgstr ""

#: ../../using/cmdline.rst:122
msgid ":pep:`338` -- Executing modules as scripts"
msgstr ""

#: ../../using/cmdline.rst:124
msgid "Supply the package name to run a ``__main__`` submodule."
msgstr ""

#: ../../using/cmdline.rst:127
msgid "namespace packages are also supported"
msgstr ""

#: ../../using/cmdline.rst:134
msgid ""
"Read commands from standard input (:data:`sys.stdin`).  If standard input is "
"a terminal, :option:`-i` is implied."
msgstr ""

#: ../../using/cmdline.rst:137
msgid ""
"If this option is given, the first element of :data:`sys.argv` will be ``\"-"
"\"`` and the current directory will be added to the start of :data:`sys."
"path`."
msgstr ""

#: ../../using/cmdline.rst:141 ../../using/cmdline.rst:796
msgid ""
"Raises an :ref:`auditing event <auditing>` ``cpython.run_stdin`` with no "
"arguments."
msgstr ""
"引發一個不附帶引數的\\ :ref:`稽核事件 <auditing>` ``cpython.run_stdin``。"

#: ../../using/cmdline.rst:147
msgid ""
"Execute the Python code contained in *script*, which must be a filesystem "
"path (absolute or relative) referring to either a Python file, a directory "
"containing a ``__main__.py`` file, or a zipfile containing a ``__main__.py`` "
"file."
msgstr ""

#: ../../using/cmdline.rst:152
msgid ""
"If this option is given, the first element of :data:`sys.argv` will be the "
"script name as given on the command line."
msgstr ""

#: ../../using/cmdline.rst:155
msgid ""
"If the script name refers directly to a Python file, the directory "
"containing that file is added to the start of :data:`sys.path`, and the file "
"is executed as the :mod:`__main__` module."
msgstr ""

#: ../../using/cmdline.rst:159
msgid ""
"If the script name refers to a directory or zipfile, the script name is "
"added to the start of :data:`sys.path` and the ``__main__.py`` file in that "
"location is executed as the :mod:`__main__` module."
msgstr ""

#: ../../using/cmdline.rst:163
msgid ""
":option:`-I` option can  be used to run the script in isolated mode where :"
"data:`sys.path` contains neither the script's directory nor the user's site-"
"packages directory. All ``PYTHON*`` environment variables are ignored, too."
msgstr ""

#: ../../using/cmdline.rst:168
msgid ""
"Raises an :ref:`auditing event <auditing>` ``cpython.run_file`` with "
"argument ``filename``."
msgstr ""
"引發一個附帶引數 ``filename`` 的\\ :ref:`稽核事件 <auditing>` ``cpython."
"run_file``。"

#: ../../using/cmdline.rst:171
msgid ":func:`runpy.run_path`"
msgstr ":func:`runpy.run_path`"

#: ../../using/cmdline.rst:175
msgid ""
"If no interface option is given, :option:`-i` is implied, ``sys.argv[0]`` is "
"an empty string (``\"\"``) and the current directory will be added to the "
"start of :data:`sys.path`.  Also, tab-completion and history editing is "
"automatically enabled, if available on your platform (see :ref:`rlcompleter-"
"config`)."
msgstr ""

#: ../../using/cmdline.rst:181
msgid ":ref:`tut-invoking`"
msgstr ":ref:`tut-invoking`"

#: ../../using/cmdline.rst:183
msgid "Automatic enabling of tab-completion and history editing."
msgstr ""

#: ../../using/cmdline.rst:190
msgid "Generic options"
msgstr ""

#: ../../using/cmdline.rst:196
msgid ""
"Print a short description of all command line options and corresponding "
"environment variables and exit."
msgstr ""

#: ../../using/cmdline.rst:201
msgid ""
"Print a short description of Python-specific environment variables and exit."
msgstr ""

#: ../../using/cmdline.rst:208
msgid ""
"Print a description of implementation-specific :option:`-X` options and exit."
msgstr ""

#: ../../using/cmdline.rst:215
msgid "Print complete usage information and exit."
msgstr "印出完整使用資訊並離開。"

#: ../../using/cmdline.rst:222
msgid "Print the Python version number and exit.  Example output could be:"
msgstr ""

#: ../../using/cmdline.rst:224
msgid "Python 3.8.0b2+"
msgstr "Python 3.8.0b2+"

#: ../../using/cmdline.rst:228
msgid "When given twice, print more information about the build, like:"
msgstr ""

#: ../../using/cmdline.rst:230
msgid ""
"Python 3.8.0b2+ (3.8:0c076caaa8, Apr 20 2019, 21:55:00)\n"
"[GCC 6.2.0 20161005]"
msgstr ""
"Python 3.8.0b2+ (3.8:0c076caaa8, Apr 20 2019, 21:55:00)\n"
"[GCC 6.2.0 20161005]"

#: ../../using/cmdline.rst:235
msgid "The ``-VV`` option."
msgstr "``-VV`` 選項"

#: ../../using/cmdline.rst:242
msgid "Miscellaneous options"
msgstr ""

#: ../../using/cmdline.rst:246
msgid ""
"Issue a warning when converting :class:`bytes` or :class:`bytearray` to :"
"class:`str` without specifying encoding or comparing :class:`!bytes` or :"
"class:`!bytearray` with :class:`!str` or :class:`!bytes` with :class:`int`. "
"Issue an error when the option is given twice (:option:`!-bb`)."
msgstr ""

#: ../../using/cmdline.rst:251
msgid "Affects also comparisons of :class:`bytes` with :class:`int`."
msgstr ""

#: ../../using/cmdline.rst:256
msgid ""
"If given, Python won't try to write ``.pyc`` files on the import of source "
"modules.  See also :envvar:`PYTHONDONTWRITEBYTECODE`."
msgstr ""

#: ../../using/cmdline.rst:262
msgid ""
"Control the validation behavior of hash-based ``.pyc`` files. See :ref:`pyc-"
"invalidation`. When set to ``default``, checked and unchecked hash-based "
"bytecode cache files are validated according to their default semantics. "
"When set to ``always``, all hash-based ``.pyc`` files, whether checked or "
"unchecked, are validated against their corresponding source file. When set "
"to ``never``, hash-based ``.pyc`` files are not validated against their "
"corresponding source files."
msgstr ""

#: ../../using/cmdline.rst:270
msgid ""
"The semantics of timestamp-based ``.pyc`` files are unaffected by this "
"option."
msgstr ""

#: ../../using/cmdline.rst:276
msgid ""
"Turn on parser debugging output (for expert only). See also the :envvar:"
"`PYTHONDEBUG` environment variable."
msgstr ""

#: ../../using/cmdline.rst:279
msgid ""
"This option requires a :ref:`debug build of Python <debug-build>`, otherwise "
"it's ignored."
msgstr ""

#: ../../using/cmdline.rst:285
msgid ""
"Ignore all ``PYTHON*`` environment variables, e.g. :envvar:`PYTHONPATH` and :"
"envvar:`PYTHONHOME`, that might be set."
msgstr ""

#: ../../using/cmdline.rst:288
msgid "See also the :option:`-P` and :option:`-I` (isolated) options."
msgstr "另請參閱 :option:`-P` 和 :option:`-I` (isolated) 選項。"

#: ../../using/cmdline.rst:293
msgid "Enter interactive mode after execution."
msgstr ""

#: ../../using/cmdline.rst:295
msgid ""
"Using the :option:`-i` option will enter interactive mode in any of the "
"following circumstances\\:"
msgstr ""

#: ../../using/cmdline.rst:297
msgid "When a script is passed as first argument"
msgstr ""

#: ../../using/cmdline.rst:298
msgid "When the :option:`-c` option is used"
msgstr ""

#: ../../using/cmdline.rst:299
msgid "When the :option:`-m` option is used"
msgstr ""

#: ../../using/cmdline.rst:301
msgid ""
"Interactive mode will start even when :data:`sys.stdin` does not appear to "
"be a terminal. The :envvar:`PYTHONSTARTUP` file is not read."
msgstr ""

#: ../../using/cmdline.rst:304
msgid ""
"This can be useful to inspect global variables or a stack trace when a "
"script raises an exception.  See also :envvar:`PYTHONINSPECT`."
msgstr ""

#: ../../using/cmdline.rst:310
msgid ""
"Run Python in isolated mode. This also implies :option:`-E`, :option:`-P` "
"and :option:`-s` options."
msgstr ""

#: ../../using/cmdline.rst:313
msgid ""
"In isolated mode :data:`sys.path` contains neither the script's directory "
"nor the user's site-packages directory. All ``PYTHON*`` environment "
"variables are ignored, too. Further restrictions may be imposed to prevent "
"the user from injecting malicious code."
msgstr ""

#: ../../using/cmdline.rst:323
msgid ""
"Remove assert statements and any code conditional on the value of :const:"
"`__debug__`.  Augment the filename for compiled (:term:`bytecode`) files by "
"adding ``.opt-1`` before the ``.pyc`` extension (see :pep:`488`).  See also :"
"envvar:`PYTHONOPTIMIZE`."
msgstr ""

#: ../../using/cmdline.rst:328 ../../using/cmdline.rst:338
msgid "Modify ``.pyc`` filenames according to :pep:`488`."
msgstr "根據 :pep:`488` 修改 ``.pyc`` 檔案名稱。"

#: ../../using/cmdline.rst:334
msgid ""
"Do :option:`-O` and also discard docstrings.  Augment the filename for "
"compiled (:term:`bytecode`) files by adding ``.opt-2`` before the ``.pyc`` "
"extension (see :pep:`488`)."
msgstr ""

#: ../../using/cmdline.rst:344
msgid "Don't prepend a potentially unsafe path to :data:`sys.path`:"
msgstr ""

#: ../../using/cmdline.rst:346
msgid ""
"``python -m module`` command line: Don't prepend the current working "
"directory."
msgstr ""

#: ../../using/cmdline.rst:348
msgid ""
"``python script.py`` command line: Don't prepend the script's directory. If "
"it's a symbolic link, resolve symbolic links."
msgstr ""

#: ../../using/cmdline.rst:350
msgid ""
"``python -c code`` and ``python`` (REPL) command lines: Don't prepend an "
"empty string, which means the current working directory."
msgstr ""

#: ../../using/cmdline.rst:353
msgid ""
"See also the :envvar:`PYTHONSAFEPATH` environment variable, and :option:`-E` "
"and :option:`-I` (isolated) options."
msgstr ""

#: ../../using/cmdline.rst:361
msgid ""
"Don't display the copyright and version messages even in interactive mode."
msgstr ""

#: ../../using/cmdline.rst:368
msgid ""
"Turn on hash randomization. This option only has an effect if the :envvar:"
"`PYTHONHASHSEED` environment variable is set to anything other than "
"``random``, since hash randomization is enabled by default."
msgstr ""

#: ../../using/cmdline.rst:372
msgid ""
"On previous versions of Python, this option turns on hash randomization, so "
"that the :meth:`~object.__hash__` values of str and bytes objects are "
"\"salted\" with an unpredictable random value.  Although they remain "
"constant within an individual Python process, they are not predictable "
"between repeated invocations of Python."
msgstr ""

#: ../../using/cmdline.rst:378
msgid ""
"Hash randomization is intended to provide protection against a denial-of-"
"service caused by carefully chosen inputs that exploit the worst case "
"performance of a dict construction, *O*\\ (*n*\\ :sup:`2`) complexity.  See "
"http://ocert.org/advisories/ocert-2011-003.html for details."
msgstr ""

#: ../../using/cmdline.rst:383
msgid ""
":envvar:`PYTHONHASHSEED` allows you to set a fixed value for the hash seed "
"secret."
msgstr ""

#: ../../using/cmdline.rst:388
msgid "The option is no longer ignored."
msgstr ""

#: ../../using/cmdline.rst:394
msgid ""
"Don't add the :data:`user site-packages directory <site.USER_SITE>` to :data:"
"`sys.path`."
msgstr ""

#: ../../using/cmdline.rst:397
msgid "See also :envvar:`PYTHONNOUSERSITE`."
msgstr "另請參閱 :envvar:`PYTHONNOUSERSITE`。"

#: ../../using/cmdline.rst:401 ../../using/cmdline.rst:893
#: ../../using/cmdline.rst:905
msgid ":pep:`370` -- Per user site-packages directory"
msgstr ""

#: ../../using/cmdline.rst:406
msgid ""
"Disable the import of the module :mod:`site` and the site-dependent "
"manipulations of :data:`sys.path` that it entails.  Also disable these "
"manipulations if :mod:`site` is explicitly imported later (call :func:`site."
"main` if you want them to be triggered)."
msgstr ""

#: ../../using/cmdline.rst:414
msgid ""
"Force the stdout and stderr streams to be unbuffered.  This option has no "
"effect on the stdin stream."
msgstr ""

#: ../../using/cmdline.rst:417
msgid "See also :envvar:`PYTHONUNBUFFERED`."
msgstr "另請參閱 :envvar:`PYTHONUNBUFFERED`。"

#: ../../using/cmdline.rst:419
msgid "The text layer of the stdout and stderr streams now is unbuffered."
msgstr ""

#: ../../using/cmdline.rst:425
msgid ""
"Print a message each time a module is initialized, showing the place "
"(filename or built-in module) from which it is loaded.  When given twice (:"
"option:`!-vv`), print a message for each file that is checked for when "
"searching for a module.  Also provides information on module cleanup at exit."
msgstr ""

#: ../../using/cmdline.rst:430
msgid ""
"The :mod:`site` module reports the site-specific paths and :file:`.pth` "
"files being processed."
msgstr ""

#: ../../using/cmdline.rst:434
msgid "See also :envvar:`PYTHONVERBOSE`."
msgstr "另請參閱 :envvar:`PYTHONVERBOSE`。"

#: ../../using/cmdline.rst:440
msgid ""
"Warning control. Python's warning machinery by default prints warning "
"messages to :data:`sys.stderr`."
msgstr ""

#: ../../using/cmdline.rst:443 ../../using/cmdline.rst:921
msgid ""
"The simplest settings apply a particular action unconditionally to all "
"warnings emitted by a process (even those that are otherwise ignored by "
"default)::"
msgstr ""

#: ../../using/cmdline.rst:447
msgid ""
"-Wdefault  # Warn once per call location\n"
"-Werror    # Convert to exceptions\n"
"-Walways   # Warn every time\n"
"-Wall      # Same as -Walways\n"
"-Wmodule   # Warn once per calling module\n"
"-Wonce     # Warn once per Python process\n"
"-Wignore   # Never warn"
msgstr ""

#: ../../using/cmdline.rst:455
msgid ""
"The action names can be abbreviated as desired and the interpreter will "
"resolve them to the appropriate action name. For example, ``-Wi`` is the "
"same as ``-Wignore``."
msgstr ""

#: ../../using/cmdline.rst:459
msgid "The full form of argument is::"
msgstr "完整的引數形式為： ::"

#: ../../using/cmdline.rst:461
msgid "action:message:category:module:lineno"
msgstr "action:message:category:module:lineno"

#: ../../using/cmdline.rst:463
msgid ""
"Empty fields match all values; trailing empty fields may be omitted. For "
"example ``-W ignore::DeprecationWarning`` ignores all DeprecationWarning "
"warnings."
msgstr ""

#: ../../using/cmdline.rst:467
msgid ""
"The *action* field is as explained above but only applies to warnings that "
"match the remaining fields."
msgstr ""

#: ../../using/cmdline.rst:470
msgid ""
"The *message* field must match the whole warning message; this match is case-"
"insensitive."
msgstr ""

#: ../../using/cmdline.rst:473
msgid ""
"The *category* field matches the warning category (ex: "
"``DeprecationWarning``). This must be a class name; the match test whether "
"the actual warning category of the message is a subclass of the specified "
"warning category."
msgstr ""

#: ../../using/cmdline.rst:478
msgid ""
"The *module* field matches the (fully qualified) module name; this match is "
"case-sensitive."
msgstr ""

#: ../../using/cmdline.rst:481
msgid ""
"The *lineno* field matches the line number, where zero matches all line "
"numbers and is thus equivalent to an omitted line number."
msgstr ""

#: ../../using/cmdline.rst:484
msgid ""
"Multiple :option:`-W` options can be given; when a warning matches more than "
"one option, the action for the last matching option is performed. Invalid :"
"option:`-W` options are ignored (though, a warning message is printed about "
"invalid options when the first warning is issued)."
msgstr ""

#: ../../using/cmdline.rst:489
msgid ""
"Warnings can also be controlled using the :envvar:`PYTHONWARNINGS` "
"environment variable and from within a Python program using the :mod:"
"`warnings` module. For example, the :func:`warnings.filterwarnings` function "
"can be used to use a regular expression on the warning message."
msgstr ""

#: ../../using/cmdline.rst:494 ../../using/cmdline.rst:933
msgid ""
"See :ref:`warning-filter` and :ref:`describing-warning-filters` for more "
"details."
msgstr ""

#: ../../using/cmdline.rst:500
msgid ""
"Skip the first line of the source, allowing use of non-Unix forms of ``#!"
"cmd``.  This is intended for a DOS specific hack only."
msgstr ""

#: ../../using/cmdline.rst:506
msgid ""
"Reserved for various implementation-specific options.  CPython currently "
"defines the following possible values:"
msgstr ""

#: ../../using/cmdline.rst:509
msgid ""
"``-X faulthandler`` to enable :mod:`faulthandler`. See also :envvar:"
"`PYTHONFAULTHANDLER`."
msgstr ""

#: ../../using/cmdline.rst:514
msgid ""
"``-X showrefcount`` to output the total reference count and number of used "
"memory blocks when the program finishes or after each statement in the "
"interactive interpreter. This only works on :ref:`debug builds <debug-"
"build>`."
msgstr ""

#: ../../using/cmdline.rst:521
msgid ""
"``-X tracemalloc`` to start tracing Python memory allocations using the :mod:"
"`tracemalloc` module. By default, only the most recent frame is stored in a "
"traceback of a trace. Use ``-X tracemalloc=NFRAME`` to start tracing with a "
"traceback limit of *NFRAME* frames. See :func:`tracemalloc.start` and :"
"envvar:`PYTHONTRACEMALLOC` for more information."
msgstr ""

#: ../../using/cmdline.rst:530
msgid ""
"``-X int_max_str_digits`` configures the :ref:`integer string conversion "
"length limitation <int_max_str_digits>`.  See also :envvar:"
"`PYTHONINTMAXSTRDIGITS`."
msgstr ""

#: ../../using/cmdline.rst:536
msgid ""
"``-X importtime`` to show how long each import takes. It shows module name, "
"cumulative time (including nested imports) and self time (excluding nested "
"imports).  Note that its output may be broken in multi-threaded "
"application.  Typical usage is ``python3 -X importtime -c 'import "
"asyncio'``.  See also :envvar:`PYTHONPROFILEIMPORTTIME`."
msgstr ""

#: ../../using/cmdline.rst:544
msgid ""
"``-X dev``: enable :ref:`Python Development Mode <devmode>`, introducing "
"additional runtime checks that are too expensive to be enabled by default.  "
"See also :envvar:`PYTHONDEVMODE`."
msgstr ""

#: ../../using/cmdline.rst:550
msgid ""
"``-X utf8`` enables the :ref:`Python UTF-8 Mode <utf8-mode>`. ``-X utf8=0`` "
"explicitly disables :ref:`Python UTF-8 Mode <utf8-mode>` (even when it would "
"otherwise activate automatically). See also :envvar:`PYTHONUTF8`."
msgstr ""

#: ../../using/cmdline.rst:557
msgid ""
"``-X pycache_prefix=PATH`` enables writing ``.pyc`` files to a parallel tree "
"rooted at the given directory instead of to the code tree. See also :envvar:"
"`PYTHONPYCACHEPREFIX`."
msgstr ""

#: ../../using/cmdline.rst:563
msgid ""
"``-X warn_default_encoding`` issues a :class:`EncodingWarning` when the "
"locale-specific default encoding is used for opening files. See also :envvar:"
"`PYTHONWARNDEFAULTENCODING`."
msgstr ""

#: ../../using/cmdline.rst:569
msgid ""
"``-X no_debug_ranges`` disables the inclusion of the tables mapping extra "
"location information (end line, start column offset and end column offset) "
"to every instruction in code objects. This is useful when smaller code "
"objects and pyc files are desired as well as suppressing the extra visual "
"location indicators when the interpreter displays tracebacks. See also :"
"envvar:`PYTHONNODEBUGRANGES`."
msgstr ""

#: ../../using/cmdline.rst:578
msgid ""
"``-X frozen_modules`` determines whether or not frozen modules are ignored "
"by the import machinery.  A value of ``on`` means they get imported and "
"``off`` means they are ignored.  The default is ``on`` if this is an "
"installed Python (the normal case).  If it's under development (running from "
"the source tree) then the default is ``off``. Note that the :mod:`!"
"importlib_bootstrap` and :mod:`!importlib_bootstrap_external` frozen modules "
"are always used, even if this flag is set to ``off``. See also :envvar:"
"`PYTHON_FROZEN_MODULES`."
msgstr ""

#: ../../using/cmdline.rst:589
msgid ""
"``-X perf`` enables support for the Linux ``perf`` profiler. When this "
"option is provided, the ``perf`` profiler will be able to report Python "
"calls. This option is only available on some platforms and will do nothing "
"if is not supported on the current system. The default value is \"off\". See "
"also :envvar:`PYTHONPERFSUPPORT` and :ref:`perf_profiling`."
msgstr ""

#: ../../using/cmdline.rst:597
msgid ""
"``-X perf_jit`` enables support for the Linux ``perf`` profiler with DWARF "
"support. When this option is provided, the ``perf`` profiler will be able to "
"report Python calls using DWARF information. This option is only available "
"on some platforms and will do nothing if is not supported on the current "
"system. The default value is \"off\". See also :envvar:"
"`PYTHON_PERF_JIT_SUPPORT` and :ref:`perf_profiling`."
msgstr ""

#: ../../using/cmdline.rst:606
msgid ""
":samp:`-X cpu_count={n}` overrides :func:`os.cpu_count`, :func:`os."
"process_cpu_count`, and :func:`multiprocessing.cpu_count`. *n* must be "
"greater than or equal to 1. This option may be useful for users who need to "
"limit CPU resources of a container system. See also :envvar:"
"`PYTHON_CPU_COUNT`. If *n* is ``default``, nothing is overridden."
msgstr ""

#: ../../using/cmdline.rst:615
msgid ""
":samp:`-X presite={package.module}` specifies a module that should be "
"imported before the :mod:`site` module is executed and before the :mod:"
"`__main__` module exists.  Therefore, the imported module isn't :mod:"
"`__main__`. This can be used to execute code early during Python "
"initialization. Python needs to be :ref:`built in debug mode <debug-build>` "
"for this option to exist.  See also :envvar:`PYTHON_PRESITE`."
msgstr ""

#: ../../using/cmdline.rst:624
msgid ""
":samp:`-X gil={0,1}` forces the GIL to be disabled or enabled, respectively. "
"Setting to ``0`` is only available in builds configured with :option:`--"
"disable-gil`. See also :envvar:`PYTHON_GIL` and :ref:`whatsnew313-free-"
"threaded-cpython`."
msgstr ""

#: ../../using/cmdline.rst:631
msgid ""
"It also allows passing arbitrary values and retrieving them through the :"
"data:`sys._xoptions` dictionary."
msgstr ""

#: ../../using/cmdline.rst:636
msgid "Removed the ``-X showalloccount`` option."
msgstr "移除 ``-X showalloccount`` 選項。"

#: ../../using/cmdline.rst:639
msgid "Removed the ``-X oldparser`` option."
msgstr "移除 ``-X oldparser`` 選項。"

#: ../../using/cmdline.rst:645
msgid "Controlling color"
msgstr ""

#: ../../using/cmdline.rst:647
msgid ""
"The Python interpreter is configured by default to use colors to highlight "
"output in certain situations such as when displaying tracebacks. This "
"behavior can be controlled by setting different environment variables."
msgstr ""

#: ../../using/cmdline.rst:651
msgid ""
"Setting the environment variable ``TERM`` to ``dumb`` will disable color."
msgstr ""

#: ../../using/cmdline.rst:653
msgid ""
"If the |FORCE_COLOR|_ environment variable is set, then color will be "
"enabled regardless of the value of TERM. This is useful on CI systems which "
"aren’t terminals but can still display ANSI escape sequences."
msgstr ""

#: ../../using/cmdline.rst:657
msgid ""
"If the |NO_COLOR|_ environment variable is set, Python will disable all "
"color in the output. This takes precedence over ``FORCE_COLOR``."
msgstr ""

#: ../../using/cmdline.rst:660
msgid ""
"All these environment variables are used also by other tools to control "
"color output. To control the color output only in the Python interpreter, "
"the :envvar:`PYTHON_COLORS` environment variable can be used. This variable "
"takes precedence over ``NO_COLOR``, which in turn takes precedence over "
"``FORCE_COLOR``."
msgstr ""

#: ../../using/cmdline.rst:675
msgid "Options you shouldn't use"
msgstr "你不該使用的選項"

#: ../../using/cmdline.rst:679
msgid "Reserved for use by Jython_."
msgstr ""

#: ../../using/cmdline.rst:687
msgid "Environment variables"
msgstr "環境變數"

#: ../../using/cmdline.rst:689
msgid ""
"These environment variables influence Python's behavior, they are processed "
"before the command-line switches other than -E or -I.  It is customary that "
"command-line switches override environmental variables where there is a "
"conflict."
msgstr ""

#: ../../using/cmdline.rst:696
msgid ""
"Change the location of the standard Python libraries.  By default, the "
"libraries are searched in :file:`{prefix}/lib/python{version}` and :file:"
"`{exec_prefix}/lib/python{version}`, where :file:`{prefix}` and :file:"
"`{exec_prefix}` are installation-dependent directories, both defaulting to :"
"file:`/usr/local`."
msgstr ""

#: ../../using/cmdline.rst:702
msgid ""
"When :envvar:`PYTHONHOME` is set to a single directory, its value replaces "
"both :file:`{prefix}` and :file:`{exec_prefix}`.  To specify different "
"values for these, set :envvar:`PYTHONHOME` to :file:`{prefix}:{exec_prefix}`."
msgstr ""

#: ../../using/cmdline.rst:709
msgid ""
"Augment the default search path for module files.  The format is the same as "
"the shell's :envvar:`PATH`: one or more directory pathnames separated by :"
"data:`os.pathsep` (e.g. colons on Unix or semicolons on Windows). Non-"
"existent directories are silently ignored."
msgstr ""

#: ../../using/cmdline.rst:714
msgid ""
"In addition to normal directories, individual :envvar:`PYTHONPATH` entries "
"may refer to zipfiles containing pure Python modules (in either source or "
"compiled form). Extension modules cannot be imported from zipfiles."
msgstr ""

#: ../../using/cmdline.rst:718
msgid ""
"The default search path is installation dependent, but generally begins "
"with :file:`{prefix}/lib/python{version}` (see :envvar:`PYTHONHOME` above).  "
"It is *always* appended to :envvar:`PYTHONPATH`."
msgstr ""

#: ../../using/cmdline.rst:722
msgid ""
"An additional directory will be inserted in the search path in front of :"
"envvar:`PYTHONPATH` as described above under :ref:`using-on-interface-"
"options`. The search path can be manipulated from within a Python program as "
"the variable :data:`sys.path`."
msgstr ""

#: ../../using/cmdline.rst:730
msgid ""
"If this is set to a non-empty string, don't prepend a potentially unsafe "
"path to :data:`sys.path`: see the :option:`-P` option for details."
msgstr ""

#: ../../using/cmdline.rst:738
msgid ""
"If this is set to a non-empty string, it overrides the :data:`sys."
"platlibdir` value."
msgstr ""

#: ../../using/cmdline.rst:746
msgid ""
"If this is the name of a readable file, the Python commands in that file are "
"executed before the first prompt is displayed in interactive mode.  The file "
"is executed in the same namespace where interactive commands are executed so "
"that objects defined or imported in it can be used without qualification in "
"the interactive session.  You can also change the prompts :data:`sys.ps1` "
"and :data:`sys.ps2` and the hook :data:`sys.__interactivehook__` in this "
"file."
msgstr ""

#: ../../using/cmdline.rst:753 ../../using/cmdline.rst:755
msgid ""
"Raises an :ref:`auditing event <auditing>` ``cpython.run_startup`` with the "
"filename as the argument when called on startup."
msgstr ""