Python.NET 安装与使用教程
本教程将指导你了解并安装 Python.NET
—— 这是一个让 Python 程序员能够无缝集成 .NET 框架的开源库。
1. 项目目录结构及介绍
在克隆或下载 pythonnet
的源代码仓库后,你会看到以下基本目录结构:
pythonnet/
├── LICENSE # 许可文件
├── MANIFEST.in # 包含构建时需要的文件列表
├── README.rst # 项目简介
├──_clr.py # .NET 兼容的 Python 模块
├──pyproject.toml # Python 项目配置文件
├──pythonnet.sln # Visual Studio 解决方案文件
├──requirements.txt # 依赖项列表
└──setup.py # Python 包构建脚本
└──version.txt # 版本号文件
LICENSE
: 项目的许可信息,这里是 MIT 许可证。MANIFEST.in
: 控制打包过程中包含哪些额外文件。README.rst
: 项目概述和说明。_clr.py
: 提供 Python 和 .NET 集成的核心模块。pyproject.toml
: 使用 Poetry 管理 Python 项目的配置。pythonnet.sln
: Visual Studio 项目文件,用于 .NET 开发。requirements.txt
: 列出项目所需的 Python 依赖包。setup.py
: Python 的 setuptools 文件,用于构建和安装包。version.txt
: 存储项目版本号的文本文件。
2. 项目启动文件介绍
Python.NET
是一个库,而不是一个有明确入口点的应用程序。不过,你可以通过导入 _clr
模块在 Python 脚本中初始化对 .NET 的访问,如下面的例子所示:
import clr
from System import String
print("Hello, .NET!")
这段代码首先导入了 clr
模块,然后从 System
命名空间导入 String
类,演示了如何调用 .NET 类型。
3. 项目的配置文件介绍
主要的配置文件是 pyproject.toml
,它是 Python 项目配置的标准。它定义了项目信息、依赖关系和构建工具等,例如:
[tool.poetry]
name = "pythonnet"
version = "3.0.3"
description = "Python for .NET is a package that gives Python programmers nearly seamless integration with the .NET Common Language Runtime (CLR)"
authors = ["The Contributors of the Python.NET Project"]
[tool.poetry.dependencies]
python = "<3.13,>=3.7"
[build-system]
requires = ["poetry-core>=1.0.0"]
build-backend = "poetry.core.masonry.api"
这个文件列出了项目的名称、版本、作者以及所需的 Python 版本。pyproject.toml
也声明了 poetry
作为依赖管理器和构建工具。
要安装 Python.NET
,确保先安装了 Poetry,然后在项目根目录下运行以下命令:
pip install poetry
poetry install
这将会安装项目及其所有依赖,使得你的 Python 环境准备好使用 Python.NET
。
更多关于 Python.NET
的详细使用方法和配置,可以参考官方文档和 Wiki 页面:
祝你在使用 Python.NET
中一切顺利!