### 如何在 VSCode 中创建和编写 Python 包 要在 Visual Studio Code (VSCode) 中创建和编写 Python 包，可以遵循以下方法： #### 1. 安装必要的扩展 为了支持 Python 开发，需安装官方的 **Python 扩展**。此扩展提供了许多功能，例如 IntelliSense、调试工具以及代码片段支持[^1]。 ```bash Ctrl + Shift + X -> 搜索并安装 "Python" 扩展 ``` #### 2. 创建项目结构 一个标准的 Python 包通常具有如下目录结构： ```plaintext mypackage/ │ ├── mypackage/ # 实际包文件夹 │ ├── __init__.py # 初始化模块 │ └── module.py # 自定义模块 │ ├── tests/ # 测试文件夹 │ └── test_module.py # 单元测试 │ └── setup.py # 构建脚本 ``` - `__init__.py` 文件用于标记当前文件夹是一个 Python 包。 - `module.py` 是实际的功能实现模块。 - `setup.py` 负责打包和分发。 #### 3. 编写初始化文件 (`__init__.py`) `__init__.py` 可以为空，也可以包含导入语句以便简化使用方式。例如： ```python from .module import MyClass, my_function ``` 这样，在其他地方可以通过以下方式访问包中的内容： ```python import mypackage mypackage.my_function() obj = mypackage.MyClass() ``` #### 4. 配置 `setup.py` `setup.py` 是构建和发布包的核心文件。以下是其基本模板： ```python from setuptools import setup, find_packages setup( name="mypackage", # 包名 version="0.1.0", # 版本号 author="Your Name", # 作者名称 description="A short description of your package.", # 描述 packages=find_packages(), # 查找所有子包 install_requires=[], # 运行依赖项 classifiers=[ # 元数据分类标签 "Programming Language :: Python :: 3", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent" ], python_requires='>=3.7' # 支持的最低版本 ) ``` 运行以下命令可生成发行版： ```bash pip install wheel python setup.py sdist bdist_wheel ``` 这将在项目的 `dist/` 文件夹下生成 `.tar.gz` 和 `.whl` 文件。 #### 5. 使用远程容器开发环境（可选） 如果希望在一个隔离环境中工作，可以利用 Remote-Containers 功能设置基于 Docker 的开发环境[^3]。通过这种方式，开发者可以在一致的环境下完成编码、调试等工作。 #### 6. 将包转换为可执行文件（可选） 对于某些场景，可能需要将整个应用程序封装成独立的可执行程序。此时可以用到 PyInstaller 或者 auto-py-to-exe 工具[^3]。这些工具有助于跨平台部署应用而无需目标机器预先安装 Python 解释器。 --- ### 示例代码 假设我们有一个简单的函数存储在 `mypackage/module.py` 中： ```python def greet(name): """Prints a greeting message.""" return f"Hello, {name}!" ``` 调用它的方式可能是这样的： ```python from mypackage.module import greet print(greet("Alice")) ``` 输出结果将是： ```plaintext Hello, Alice! ``` ---