gooderp18绿色标准版
Du kannst nicht mehr als 25 Themen auswählen Themen müssen entweder mit einem Buchstaben oder einer Ziffer beginnen. Sie können Bindestriche („-“) enthalten und bis zu 35 Zeichen lang sein.

386 Zeilen
19KB

  1. <!DOCTYPE html>
  2. <html lang="en" data-content_root="../">
  3. <head>
  4. <meta charset="utf-8" />
  5. <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
  6. <meta property="og:title" content="Debugging and Profiling" />
  7. <meta property="og:type" content="website" />
  8. <meta property="og:url" content="https://docs.python.org/3/library/debug.html" />
  9. <meta property="og:site_name" content="Python documentation" />
  10. <meta property="og:description" content="These libraries help you with Python development: the debugger enables you to step through code, analyze stack frames and set breakpoints etc., and the profilers run code and give you a detailed br..." />
  11. <meta property="og:image" content="https://docs.python.org/3/_static/og-image.png" />
  12. <meta property="og:image:alt" content="Python documentation" />
  13. <meta name="description" content="These libraries help you with Python development: the debugger enables you to step through code, analyze stack frames and set breakpoints etc., and the profilers run code and give you a detailed br..." />
  14. <meta property="og:image:width" content="200" />
  15. <meta property="og:image:height" content="200" />
  16. <meta name="theme-color" content="#3776ab" />
  17. <title>Debugging and Profiling &#8212; Python 3.12.3 documentation</title><meta name="viewport" content="width=device-width, initial-scale=1.0">
  18. <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=80d5e7a1" />
  19. <link rel="stylesheet" type="text/css" href="../_static/pydoctheme.css?v=bb723527" />
  20. <link id="pygments_dark_css" media="(prefers-color-scheme: dark)" rel="stylesheet" type="text/css" href="../_static/pygments_dark.css?v=b20cc3f5" />
  21. <script src="../_static/documentation_options.js?v=2c828074"></script>
  22. <script src="../_static/doctools.js?v=888ff710"></script>
  23. <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
  24. <script src="../_static/sidebar.js"></script>
  25. <link rel="search" type="application/opensearchdescription+xml"
  26. title="Search within Python 3.12.3 documentation"
  27. href="../_static/opensearch.xml"/>
  28. <link rel="author" title="About these documents" href="../about.html" />
  29. <link rel="index" title="Index" href="../genindex.html" />
  30. <link rel="search" title="Search" href="../search.html" />
  31. <link rel="copyright" title="Copyright" href="../copyright.html" />
  32. <link rel="next" title="Audit events table" href="audit_events.html" />
  33. <link rel="prev" title="test — Regression tests package for Python" href="test.html" />
  34. <link rel="canonical" href="https://docs.python.org/3/library/debug.html" />
  35. <style>
  36. @media only screen {
  37. table.full-width-table {
  38. width: 100%;
  39. }
  40. }
  41. </style>
  42. <link rel="stylesheet" href="../_static/pydoctheme_dark.css" media="(prefers-color-scheme: dark)" id="pydoctheme_dark_css">
  43. <link rel="shortcut icon" type="image/png" href="../_static/py.svg" />
  44. <script type="text/javascript" src="../_static/copybutton.js"></script>
  45. <script type="text/javascript" src="../_static/menu.js"></script>
  46. <script type="text/javascript" src="../_static/search-focus.js"></script>
  47. <script type="text/javascript" src="../_static/themetoggle.js"></script>
  48. </head>
  49. <body>
  50. <div class="mobile-nav">
  51. <input type="checkbox" id="menuToggler" class="toggler__input" aria-controls="navigation"
  52. aria-pressed="false" aria-expanded="false" role="button" aria-label="Menu" />
  53. <nav class="nav-content" role="navigation">
  54. <label for="menuToggler" class="toggler__label">
  55. <span></span>
  56. </label>
  57. <span class="nav-items-wrapper">
  58. <a href="https://www.python.org/" class="nav-logo">
  59. <img src="../_static/py.svg" alt="Python logo"/>
  60. </a>
  61. <span class="version_switcher_placeholder"></span>
  62. <form role="search" class="search" action="../search.html" method="get">
  63. <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" class="search-icon">
  64. <path fill-rule="nonzero" fill="currentColor" d="M15.5 14h-.79l-.28-.27a6.5 6.5 0 001.48-5.34c-.47-2.78-2.79-5-5.59-5.34a6.505 6.505 0 00-7.27 7.27c.34 2.8 2.56 5.12 5.34 5.59a6.5 6.5 0 005.34-1.48l.27.28v.79l4.25 4.25c.41.41 1.08.41 1.49 0 .41-.41.41-1.08 0-1.49L15.5 14zm-6 0C7.01 14 5 11.99 5 9.5S7.01 5 9.5 5 14 7.01 14 9.5 11.99 14 9.5 14z"></path>
  65. </svg>
  66. <input placeholder="Quick search" aria-label="Quick search" type="search" name="q" />
  67. <input type="submit" value="Go"/>
  68. </form>
  69. </span>
  70. </nav>
  71. <div class="menu-wrapper">
  72. <nav class="menu" role="navigation" aria-label="main navigation">
  73. <div class="language_switcher_placeholder"></div>
  74. <label class="theme-selector-label">
  75. Theme
  76. <select class="theme-selector" oninput="activateTheme(this.value)">
  77. <option value="auto" selected>Auto</option>
  78. <option value="light">Light</option>
  79. <option value="dark">Dark</option>
  80. </select>
  81. </label>
  82. <div>
  83. <h4>Previous topic</h4>
  84. <p class="topless"><a href="test.html"
  85. title="previous chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">test</span></code> — Regression tests package for Python</a></p>
  86. </div>
  87. <div>
  88. <h4>Next topic</h4>
  89. <p class="topless"><a href="audit_events.html"
  90. title="next chapter">Audit events table</a></p>
  91. </div>
  92. <div role="note" aria-label="source link">
  93. <h3>This Page</h3>
  94. <ul class="this-page-menu">
  95. <li><a href="../bugs.html">Report a Bug</a></li>
  96. <li>
  97. <a href="https://github.com/python/cpython/blob/main/Doc/library/debug.rst"
  98. rel="nofollow">Show Source
  99. </a>
  100. </li>
  101. </ul>
  102. </div>
  103. </nav>
  104. </div>
  105. </div>
  106. <div class="related" role="navigation" aria-label="related navigation">
  107. <h3>Navigation</h3>
  108. <ul>
  109. <li class="right" style="margin-right: 10px">
  110. <a href="../genindex.html" title="General Index"
  111. accesskey="I">index</a></li>
  112. <li class="right" >
  113. <a href="../py-modindex.html" title="Python Module Index"
  114. >modules</a> |</li>
  115. <li class="right" >
  116. <a href="audit_events.html" title="Audit events table"
  117. accesskey="N">next</a> |</li>
  118. <li class="right" >
  119. <a href="test.html" title="test — Regression tests package for Python"
  120. accesskey="P">previous</a> |</li>
  121. <li><img src="../_static/py.svg" alt="Python logo" style="vertical-align: middle; margin-top: -1px"/></li>
  122. <li><a href="https://www.python.org/">Python</a> &#187;</li>
  123. <li class="switchers">
  124. <div class="language_switcher_placeholder"></div>
  125. <div class="version_switcher_placeholder"></div>
  126. </li>
  127. <li>
  128. </li>
  129. <li id="cpython-language-and-version">
  130. <a href="../index.html">3.12.3 Documentation</a> &#187;
  131. </li>
  132. <li class="nav-item nav-item-1"><a href="index.html" accesskey="U">The Python Standard Library</a> &#187;</li>
  133. <li class="nav-item nav-item-this"><a href="">Debugging and Profiling</a></li>
  134. <li class="right">
  135. <div class="inline-search" role="search">
  136. <form class="inline-search" action="../search.html" method="get">
  137. <input placeholder="Quick search" aria-label="Quick search" type="search" name="q" id="search-box" />
  138. <input type="submit" value="Go" />
  139. </form>
  140. </div>
  141. |
  142. </li>
  143. <li class="right">
  144. <label class="theme-selector-label">
  145. Theme
  146. <select class="theme-selector" oninput="activateTheme(this.value)">
  147. <option value="auto" selected>Auto</option>
  148. <option value="light">Light</option>
  149. <option value="dark">Dark</option>
  150. </select>
  151. </label> |</li>
  152. </ul>
  153. </div>
  154. <div class="document">
  155. <div class="documentwrapper">
  156. <div class="bodywrapper">
  157. <div class="body" role="main">
  158. <section id="debugging-and-profiling">
  159. <h1>Debugging and Profiling<a class="headerlink" href="#debugging-and-profiling" title="Link to this heading">¶</a></h1>
  160. <p>These libraries help you with Python development: the debugger enables you to
  161. step through code, analyze stack frames and set breakpoints etc., and the
  162. profilers run code and give you a detailed breakdown of execution times,
  163. allowing you to identify bottlenecks in your programs. Auditing events
  164. provide visibility into runtime behaviors that would otherwise require
  165. intrusive debugging or patching.</p>
  166. <div class="toctree-wrapper compound">
  167. <ul>
  168. <li class="toctree-l1"><a class="reference internal" href="audit_events.html">Audit events table</a></li>
  169. <li class="toctree-l1"><a class="reference internal" href="bdb.html"><code class="xref py py-mod docutils literal notranslate"><span class="pre">bdb</span></code> — Debugger framework</a></li>
  170. <li class="toctree-l1"><a class="reference internal" href="faulthandler.html"><code class="xref py py-mod docutils literal notranslate"><span class="pre">faulthandler</span></code> — Dump the Python traceback</a><ul>
  171. <li class="toctree-l2"><a class="reference internal" href="faulthandler.html#dumping-the-traceback">Dumping the traceback</a></li>
  172. <li class="toctree-l2"><a class="reference internal" href="faulthandler.html#fault-handler-state">Fault handler state</a></li>
  173. <li class="toctree-l2"><a class="reference internal" href="faulthandler.html#dumping-the-tracebacks-after-a-timeout">Dumping the tracebacks after a timeout</a></li>
  174. <li class="toctree-l2"><a class="reference internal" href="faulthandler.html#dumping-the-traceback-on-a-user-signal">Dumping the traceback on a user signal</a></li>
  175. <li class="toctree-l2"><a class="reference internal" href="faulthandler.html#issue-with-file-descriptors">Issue with file descriptors</a></li>
  176. <li class="toctree-l2"><a class="reference internal" href="faulthandler.html#example">Example</a></li>
  177. </ul>
  178. </li>
  179. <li class="toctree-l1"><a class="reference internal" href="pdb.html"><code class="xref py py-mod docutils literal notranslate"><span class="pre">pdb</span></code> — The Python Debugger</a><ul>
  180. <li class="toctree-l2"><a class="reference internal" href="pdb.html#debugger-commands">Debugger Commands</a></li>
  181. </ul>
  182. </li>
  183. <li class="toctree-l1"><a class="reference internal" href="profile.html">The Python Profilers</a><ul>
  184. <li class="toctree-l2"><a class="reference internal" href="profile.html#introduction-to-the-profilers">Introduction to the profilers</a></li>
  185. <li class="toctree-l2"><a class="reference internal" href="profile.html#instant-user-s-manual">Instant User’s Manual</a></li>
  186. <li class="toctree-l2"><a class="reference internal" href="profile.html#module-cProfile"><code class="xref py py-mod docutils literal notranslate"><span class="pre">profile</span></code> and <code class="xref py py-mod docutils literal notranslate"><span class="pre">cProfile</span></code> Module Reference</a></li>
  187. <li class="toctree-l2"><a class="reference internal" href="profile.html#the-stats-class">The <code class="xref py py-class docutils literal notranslate"><span class="pre">Stats</span></code> Class</a></li>
  188. <li class="toctree-l2"><a class="reference internal" href="profile.html#what-is-deterministic-profiling">What Is Deterministic Profiling?</a></li>
  189. <li class="toctree-l2"><a class="reference internal" href="profile.html#limitations">Limitations</a></li>
  190. <li class="toctree-l2"><a class="reference internal" href="profile.html#calibration">Calibration</a></li>
  191. <li class="toctree-l2"><a class="reference internal" href="profile.html#using-a-custom-timer">Using a custom timer</a></li>
  192. </ul>
  193. </li>
  194. <li class="toctree-l1"><a class="reference internal" href="timeit.html"><code class="xref py py-mod docutils literal notranslate"><span class="pre">timeit</span></code> — Measure execution time of small code snippets</a><ul>
  195. <li class="toctree-l2"><a class="reference internal" href="timeit.html#basic-examples">Basic Examples</a></li>
  196. <li class="toctree-l2"><a class="reference internal" href="timeit.html#python-interface">Python Interface</a></li>
  197. <li class="toctree-l2"><a class="reference internal" href="timeit.html#command-line-interface">Command-Line Interface</a></li>
  198. <li class="toctree-l2"><a class="reference internal" href="timeit.html#examples">Examples</a></li>
  199. </ul>
  200. </li>
  201. <li class="toctree-l1"><a class="reference internal" href="trace.html"><code class="xref py py-mod docutils literal notranslate"><span class="pre">trace</span></code> — Trace or track Python statement execution</a><ul>
  202. <li class="toctree-l2"><a class="reference internal" href="trace.html#command-line-usage">Command-Line Usage</a><ul>
  203. <li class="toctree-l3"><a class="reference internal" href="trace.html#main-options">Main options</a></li>
  204. <li class="toctree-l3"><a class="reference internal" href="trace.html#modifiers">Modifiers</a></li>
  205. <li class="toctree-l3"><a class="reference internal" href="trace.html#filters">Filters</a></li>
  206. </ul>
  207. </li>
  208. <li class="toctree-l2"><a class="reference internal" href="trace.html#programmatic-interface">Programmatic Interface</a></li>
  209. </ul>
  210. </li>
  211. <li class="toctree-l1"><a class="reference internal" href="tracemalloc.html"><code class="xref py py-mod docutils literal notranslate"><span class="pre">tracemalloc</span></code> — Trace memory allocations</a><ul>
  212. <li class="toctree-l2"><a class="reference internal" href="tracemalloc.html#examples">Examples</a><ul>
  213. <li class="toctree-l3"><a class="reference internal" href="tracemalloc.html#display-the-top-10">Display the top 10</a></li>
  214. <li class="toctree-l3"><a class="reference internal" href="tracemalloc.html#compute-differences">Compute differences</a></li>
  215. <li class="toctree-l3"><a class="reference internal" href="tracemalloc.html#get-the-traceback-of-a-memory-block">Get the traceback of a memory block</a></li>
  216. <li class="toctree-l3"><a class="reference internal" href="tracemalloc.html#pretty-top">Pretty top</a><ul>
  217. <li class="toctree-l4"><a class="reference internal" href="tracemalloc.html#record-the-current-and-peak-size-of-all-traced-memory-blocks">Record the current and peak size of all traced memory blocks</a></li>
  218. </ul>
  219. </li>
  220. </ul>
  221. </li>
  222. <li class="toctree-l2"><a class="reference internal" href="tracemalloc.html#api">API</a><ul>
  223. <li class="toctree-l3"><a class="reference internal" href="tracemalloc.html#functions">Functions</a></li>
  224. <li class="toctree-l3"><a class="reference internal" href="tracemalloc.html#domainfilter">DomainFilter</a></li>
  225. <li class="toctree-l3"><a class="reference internal" href="tracemalloc.html#filter">Filter</a></li>
  226. <li class="toctree-l3"><a class="reference internal" href="tracemalloc.html#frame">Frame</a></li>
  227. <li class="toctree-l3"><a class="reference internal" href="tracemalloc.html#snapshot">Snapshot</a></li>
  228. <li class="toctree-l3"><a class="reference internal" href="tracemalloc.html#statistic">Statistic</a></li>
  229. <li class="toctree-l3"><a class="reference internal" href="tracemalloc.html#statisticdiff">StatisticDiff</a></li>
  230. <li class="toctree-l3"><a class="reference internal" href="tracemalloc.html#trace">Trace</a></li>
  231. <li class="toctree-l3"><a class="reference internal" href="tracemalloc.html#traceback">Traceback</a></li>
  232. </ul>
  233. </li>
  234. </ul>
  235. </li>
  236. </ul>
  237. </div>
  238. </section>
  239. <div class="clearer"></div>
  240. </div>
  241. </div>
  242. </div>
  243. <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
  244. <div class="sphinxsidebarwrapper">
  245. <div>
  246. <h4>Previous topic</h4>
  247. <p class="topless"><a href="test.html"
  248. title="previous chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">test</span></code> — Regression tests package for Python</a></p>
  249. </div>
  250. <div>
  251. <h4>Next topic</h4>
  252. <p class="topless"><a href="audit_events.html"
  253. title="next chapter">Audit events table</a></p>
  254. </div>
  255. <div role="note" aria-label="source link">
  256. <h3>This Page</h3>
  257. <ul class="this-page-menu">
  258. <li><a href="../bugs.html">Report a Bug</a></li>
  259. <li>
  260. <a href="https://github.com/python/cpython/blob/main/Doc/library/debug.rst"
  261. rel="nofollow">Show Source
  262. </a>
  263. </li>
  264. </ul>
  265. </div>
  266. </div>
  267. <div id="sidebarbutton" title="Collapse sidebar">
  268. <span>«</span>
  269. </div>
  270. </div>
  271. <div class="clearer"></div>
  272. </div>
  273. <div class="related" role="navigation" aria-label="related navigation">
  274. <h3>Navigation</h3>
  275. <ul>
  276. <li class="right" style="margin-right: 10px">
  277. <a href="../genindex.html" title="General Index"
  278. >index</a></li>
  279. <li class="right" >
  280. <a href="../py-modindex.html" title="Python Module Index"
  281. >modules</a> |</li>
  282. <li class="right" >
  283. <a href="audit_events.html" title="Audit events table"
  284. >next</a> |</li>
  285. <li class="right" >
  286. <a href="test.html" title="test — Regression tests package for Python"
  287. >previous</a> |</li>
  288. <li><img src="../_static/py.svg" alt="Python logo" style="vertical-align: middle; margin-top: -1px"/></li>
  289. <li><a href="https://www.python.org/">Python</a> &#187;</li>
  290. <li class="switchers">
  291. <div class="language_switcher_placeholder"></div>
  292. <div class="version_switcher_placeholder"></div>
  293. </li>
  294. <li>
  295. </li>
  296. <li id="cpython-language-and-version">
  297. <a href="../index.html">3.12.3 Documentation</a> &#187;
  298. </li>
  299. <li class="nav-item nav-item-1"><a href="index.html" >The Python Standard Library</a> &#187;</li>
  300. <li class="nav-item nav-item-this"><a href="">Debugging and Profiling</a></li>
  301. <li class="right">
  302. <div class="inline-search" role="search">
  303. <form class="inline-search" action="../search.html" method="get">
  304. <input placeholder="Quick search" aria-label="Quick search" type="search" name="q" id="search-box" />
  305. <input type="submit" value="Go" />
  306. </form>
  307. </div>
  308. |
  309. </li>
  310. <li class="right">
  311. <label class="theme-selector-label">
  312. Theme
  313. <select class="theme-selector" oninput="activateTheme(this.value)">
  314. <option value="auto" selected>Auto</option>
  315. <option value="light">Light</option>
  316. <option value="dark">Dark</option>
  317. </select>
  318. </label> |</li>
  319. </ul>
  320. </div>
  321. <div class="footer">
  322. &copy;
  323. <a href="../copyright.html">
  324. Copyright
  325. </a>
  326. 2001-2024, Python Software Foundation.
  327. <br />
  328. This page is licensed under the Python Software Foundation License Version 2.
  329. <br />
  330. Examples, recipes, and other code in the documentation are additionally licensed under the Zero Clause BSD License.
  331. <br />
  332. See <a href="/license.html">History and License</a> for more information.<br />
  333. <br />
  334. The Python Software Foundation is a non-profit corporation.
  335. <a href="https://www.python.org/psf/donations/">Please donate.</a>
  336. <br />
  337. <br />
  338. Last updated on Apr 09, 2024 (13:47 UTC).
  339. <a href="/bugs.html">Found a bug</a>?
  340. <br />
  341. Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.2.6.
  342. </div>
  343. </body>
  344. </html>
上海开阖软件有限公司 沪ICP备12045867号-1