【亲测免费】 PyScript 入门教程

2026-01-17 08:29:06作者：董宙帆

1. 项目目录结构及介绍

PyScript 的源码仓库并未提供具体的目录结构说明。通常，一个 Python 开源项目可能包含以下结构：

my_pyscript_project/
├── src/         # 主要代码目录
│   ├── pyscript/      # PyScript 源码
│   └── ...
├── tests/        # 单元测试
├── setup.py      # 项目安装配置
├── README.md     # 项目简介
├── requirements.txt # 依赖包列表
└── .gitignore    # Git 忽略文件

不过，对于 pyscript/pyscript 仓库，我们可以假设主要的 Python 代码位于根目录下，且包含了用于在浏览器中运行的组件。

2. 项目启动文件介绍

PyScript 是设计用于浏览器中的，因此没有传统的 "启动文件"，如 main.py。它的核心是通过 HTML 和 <script type="py"> 标签将 Python 逻辑集成到网页中。例如，一个简单的页面可以这样写：

<!DOCTYPE html>
<html>
<head>
  <link rel="stylesheet" href="https://pyscript.net/latest/pyscript.css" />
  <script defer src="https://pyscript.net/latest/pyscript.js"></script>
</head>
<body>
  <pyscript>
    from pyscript import *
    
    @pyscript.run
    def greet():
        print("Hello, PyScript!")
        
    greet()
  </pyscript>
</body>
</html>

在这个例子中，<pyscript> 标签内的代码就是 PyScript 的启动点，它会在页面加载完成后执行。

3. 项目的配置文件介绍

由于 PyScript 在浏览器环境中运行，所以没有标准的配置文件（如 .ini 或 config.yaml）。然而，你可以通过 JavaScript API 来配置 PyScript 的行为。例如，在 HTML 中设置 Pyodide 版本或调试模式：

<script id="pys-config">
  window.PyScriptConfig = {
    pyodide_url: 'https://cdn.jsdelivr.net/pyodide/v0.18.1/full/pyodide.js', // 设置 Pyodide 版本
    debug_mode: true, // 启用调试模式
  };
</script>

<!-- 然后在 pyscript.js 之后引入 -->
<script defer src="https://pyscript.net/latest/pyscript.js"></script>