如何在创建NamedTuple时为类属性设置别名？

你尝试的直接赋值方式行不通，因为NamedTuple字段定义里的=是用来设置默认值的，而非别名。下面提供两种可行方案：

方案一：通过子类添加属性别名（只读） #

如果只需要读取时能用init_version替代project_version，可以创建一个继承自原NamedTuple的子类，用@property实现别名：

from typing import NamedTuple
from pathlib import Path

class _ProjectMetadata(NamedTuple):
    """内部基类，定义原始字段结构"""
    config_file: Path
    package_name: str
    project_name: str
    project_path: Path
    project_version: str
    source_dir: Path

class ProjectMetadata(_ProjectMetadata):
    """对外暴露的元数据类，包含字段别名"""
    @property
    def init_version(self) -> str:
        return self.project_version

使用时，既可以通过instance.project_version访问，也可以用instance.init_version获取同一个值。

方案二：支持别名参数初始化 #

如果需要在创建实例时，既能用project_version也能用init_version作为参数传入，可以重写__new__方法来处理参数映射：

from typing import NamedTuple, Optional
from pathlib import Path

class ProjectMetadata(NamedTuple):
    """Structure holding project metadata derived from `pyproject.toml`"""
    config_file: Path
    package_name: str
    project_name: str
    project_path: Path
    project_version: str
    source_dir: Path

    def __new__(cls, 
                config_file: Path,
                package_name: str,
                project_name: str,
                project_path: Path,
                project_version: Optional[str] = None,
                init_version: Optional[str] = None,
                source_dir: Path):
        # 确保必须传入其中一个版本参数
        if project_version is None and init_version is None:
            raise ValueError("必须提供project_version或init_version参数")
        # 优先使用project_version，否则用init_version的值
        target_version = project_version if project_version is not None else init_version
        # 调用父类的__new__创建实例
        return super().__new__(cls, 
                               config_file=config_file,
                               package_name=package_name,
                               project_name=project_name,
                               project_path=project_path,
                               project_version=target_version,
                               source_dir=source_dir)

这样创建实例时，两种参数写法都有效：

# 用原字段名创建
meta1 = ProjectMetadata(
    config_file=Path("pyproject.toml"),
    package_name="my-package",
    project_name="My Package",
    project_path=Path("."),
    project_version="1.0.0",
    source_dir=Path("src")
)

# 用别名创建
meta2 = ProjectMetadata(
    config_file=Path("pyproject.toml"),
    package_name="my-package",
    project_name="My Package",
    project_path=Path("."),
    init_version="1.0.0",
    source_dir=Path("src")
)

内容的提问来源于stack exchange，提问作者Blueynuey