PyScript 无法直接访问本地文件系统，但可通过配置 files 键将远程或本地托管的文件预加载至内置虚拟文件系统，使 open() 等标准 I/O 操作正常工作。
pyscript 无法直接访问本地文件系统，但可通过配置 `files` 键将远程或本地托管的文件预加载至内置虚拟文件系统，使 `open()` 等标准 i/o 操作正常工作。
在 PyScript 中运行依赖文件的 Python 脚本时，常见的错误是调用 open("data.txt") 后抛出 FileNotFoundError。这是因为浏览器沙箱机制禁止 Web 应用（包括 PyScript）直接读取用户本地磁盘文件——这是强制性的安全限制，不可绕过。但 PyScript 提供了安全、声明式的替代方案：通过 <py-config> 的 files 配置项，将文件预先加载进内存中的虚拟文件系统（VFS）。该 VFS 对 Python 运行时完全透明，open()、os.path.exists()、pathlib.Path.read_text() 等所有标准文件 API 均可无缝使用。
✅ 正确做法：使用 files 配置加载文件
确保目标文件可通过 HTTP 访问（例如部署在 Web 服务器、GitHub Pages、Vercel，或本地快速启动一个开发服务器）：
# 在项目根目录启动简易 HTTP 服务（Python 3.7+） python3 -m http.server 8000 # 文件 now accessible at http://localhost:8000/data.csv
然后在 HTML 中配置 <py-config>：
<py-config>
{
"files": [
"data.csv",
"config.json",
"assets/script.py"
]
}
</py-config>
<py-script>
# 现在可直接使用 open() —— 文件已存在于虚拟文件系统中
with open("data.csv", "r") as f:
content = f.read()
print("Loaded CSV lines:", len(content.splitlines()))
import json
with open("config.json") as f:
config = json.load(f)
print("Config version:", config.get("version"))
</py-script>? 关键说明：files 列表中的路径是相对于当前 HTML 页面的 URL 路径（非本地文件路径）。上述示例要求 data.csv 与 HTML 文件同目录，且能被 Web 服务器正确响应（HTTP 200）。
⚠️ 注意事项与最佳实践
- ❌ 不要使用 fetch + Blob + FileReader 手动写入 VFS：虽技术可行，但易出错、不兼容 open() 的同步语义，且破坏 PyScript 的声明式设计哲学；
- ✅ 优先使用 files 而非已弃用的 [[fetch]]：后者配置复杂、易因 MIME 类型/编码问题失败，官方文档明确推荐 files 为当前标准方式；
- ? 路径需为静态资源路径：支持子目录（如 "assets/logo.png"），但不支持动态生成或跨域（CORS）资源（除非目标服务器显式允许）；
- ? 本地开发调试建议：始终搭配 http.server 或 live-server 启动，切勿直接双击 HTML 打开（此时为 file:// 协议，浏览器会阻止所有 fetch 请求）；
- ? 大文件注意性能：虚拟文件系统全部驻留内存，单文件建议 ≤50MB；超大文件应考虑流式处理或后端 API 支持。
✅ 总结
PyScript 的 files 配置是连接 Web 安全模型与 Python 文件生态的关键桥梁。它不突破浏览器限制，而是以受控、可审计的方式将网络资源“挂载”为 Python 可见的文件。只要确保文件可被 HTTP 获取，并在 <py-config> 中准确声明，你的算法即可像在本地环境中一样自然地调用 open()、处理 CSV/JSON/文本等资源——安全、简洁、可靠。
