【亲测免费】 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 Github 主页
• Python.NET 文档

祝你在使用 Python.NET 中一切顺利！