更新 sys.getfilesystemencoding

删除Py_FileSystemDefaultEncoding的默认值，并在initfsencoding()中将其设置为 utf-8，或者如果启用了传统模式开关则设置为 mbcs。

更新PyUnicode_DecodeFSDefaultAndSize()和PyUnicode_EncodeFSDefault()的实现，以使用 utf-8 编码器，或者如果启用了传统模式开关则使用现有的 mbcs 编码器。

添加 sys.getfilesystemencodeerrors

由于错误模式现在可能在surrogatepass和replace之间更改，因此手动执行编码的 Python 代码也需要访问当前错误模式。这包括os.fsencode()和os.fsdecode()的实现，这些实现目前假设基于编码器的错误模式。

添加一个公共Py_FileSystemDefaultEncodeErrors，类似于现有的Py_FileSystemDefaultEncoding。Windows 上的默认值为surrogatepass，或在传统模式下为replace。所有其他平台上的默认值为surrogateescape。

添加一个公共sys.getfilesystemencodeerrors()函数，该函数返回当前错误模式。

更新PyUnicode_DecodeFSDefaultAndSize()和PyUnicode_EncodeFSDefault()的实现，以使用错误模式变量而不是常量字符串。

更新os.fsencode()和os.fsdecode()的实现，以使用sys.getfilesystemencodeerrors()而不是假设模式。

更新 path_converter

更新路径转换器，始终使用PyUnicode_DecodeFSDefaultAndSize()将字节或缓冲区对象解码为文本。

将narrow字段从char*字符串更改为一个标志，该标志指示原始对象是否为字节。对于需要使用与最初提供的相同类型返回路径的函数，这是必需的。

移除未使用的 ANSI 代码

删除所有使用narrow字段的代码路径，因为任何调用者都将无法再访问这些路径。这些仅在posixmodule.c中使用。路径的其他用途应已将字节路径的使用替换为解码和使用 *W API。

添加传统模式

添加一个旧版模式标志，可以通过环境变量 PYTHONLEGACYWINDOWSFSENCODING 或调用函数 sys._enablelegacywindowsfsencoding() 来启用。函数调用只能用于启用该标志，并且应该在程序初始化阶段尽可能早地使用。旧版模式无法在 Python 运行期间禁用。

当设置此标志时，默认的文件系统编码将设置为 mbcs 而不是 utf-8，错误模式将设置为 replace 而不是 surrogatepass。路径将继续解码为宽字符，并且只会调用 *W API，但是，从 Python 传入和接收的字节将与更改之前一样进行编码。

取消弃用 Windows 上的字节路径

在 Windows 上使用字节作为路径目前已弃用。我们将宣布这种情况不再存在，并且当路径编码为字节时，应使用 sys.getfilesystemencoding() 返回的值而不是用户的活动代码页。

Beta 实验

为了帮助确定此更改的影响，我们建议将其临时应用于 3.6.0b1，目的是在 3.6.0b4 之前做出最终决定。

在实验期间，解码和编码异常消息将扩展为包含指向活动在线讨论的链接，并鼓励报告问题。

如果决定在 3.6.0b4 中恢复该功能，则实现更改将是永久启用旧版模式标志，将环境变量更改为 PYTHONWINDOWSUTF8FSENCODING，并将函数更改为 sys._enablewindowsutf8fsencoding()，以便能够根据具体情况启用该功能，而不是禁用它。

预计如果由于兼容性问题而无法在 3.6 中实现此更改，那么在 Python 3.x 的任何后期版本中都将无法实现此更改。

受影响的模块

此 PEP 隐式包含 Python 中所有模块，这些模块要么将路径名传递给操作系统，要么以其他方式使用 sys.getfilesystemencoding()。

截至 3.6.0a4，以下模块需要修改

• os
• _overlapped
• _socket
• subprocess
• zipimport

以下模块使用 sys.getfilesystemencoding()，但不需要修改

• gc（已经假设字节为 utf-8）
• grp（未为 Windows 编译）
• http.server（正确地包含了与传输数据一起使用的编解码器名称）
• idlelib.editor（应该不需要；具有回退处理）
• nis（未为 Windows 编译）
• pwd（未为 Windows 编译）
• spwd（未为 Windows 编译）
• _ssl（仅用于 ASCII 常量）
• tarfile（在 Windows 上未使用代码）
• _tkinter（已经假设字节为 utf-8）
• wsgiref（假设为未知环境的默认编码）
• zipapp（在 Windows 上未使用代码）

以下原生代码使用其中一个编码或解码函数，但不需要任何修改

• Parser/parsetok.c（文档已指定 sys.getfilesystemencoding()）
• Python/ast.c（文档已指定 sys.getfilesystemencoding()）
• Python/compile.c（未记录，但隐含 Python 文件系统编码）
• Python/errors.c（文档已指定 os.fsdecode()）
• Python/fileutils.c（在 Windows 上未使用代码）
• Python/future.c（未记录，但隐含 Python 文件系统编码）
• Python/import.c（文档已指定 utf-8）
• Python/importdl.c（在 Windows 上未使用代码）
• Python/pythonrun.c（文档已指定 sys.getfilesystemencoding()）
• Python/symtable.c（未记录，但隐含 Python 文件系统编码）
• Python/thread.c（在 Windows 上未使用代码）
• Python/traceback.c（正确编码以比较字符串）
• Python/_warnings.c（文档已指定 os.fsdecode()）

使用严格的 mbcs 解码

这与提议的更改基本相同，但它不是将 sys.getfilesystemencoding() 更改为 utf-8，而是将其更改为 mbcs（动态映射到活动代码页）。

这种方法允许使用仅作为 *W API 可用的新功能，以及检测编码/解码错误。例如，它可以发出警告或使操作失败，而不是将 Unicode 字符静默替换为“？”。

与提议的修复相比，这可以启用一些新功能，但不会修复最初描述的任何问题。新的运行时错误可能会导致某些问题变得更加明显并导致修复，前提是库维护人员有兴趣支持 Windows 并添加单独的代码路径以将文件系统路径视为字符串。

在没有严格错误的情况下使编码为 mbcs 等效于默认情况下启用了旧版模式开关。如果实际代码存在大量中断，并且需要延长弃用期，但仍然希望对 CPython 源代码进行简化，则这是一种可能的行动方案。

将字节路径在 Windows 上设为错误

通过完全阻止在 Windows 上使用字节路径，我们阻止用户遇到编码问题。

但是，此 PEP 的动机是提高在 POSIX 上编写的代码在 Windows 上也能正确工作的可能性。这种替代方案将朝着另一个方向发展，并使此类代码完全不兼容。由于这不会以任何方式使用户受益，因此我们拒绝它。

将字节路径在所有平台上设为错误

通过弃用然后禁用所有平台上的字节路径的使用，我们阻止用户遇到编码问题，无论代码最初是在哪里编写的。这将需要一个完整的弃用周期，因为目前除了 Windows 之外的其他平台上没有警告。

这很可能会被视为对 Python 开发人员的敌对行为，因此目前被拒绝。

不跨边界管理编码

在跨越协议边界时不管理编码的代码目前可能碰巧正常工作，但在任何编码更改时都可能遇到问题。请注意，filename 的来源可能是任何返回字节对象的函数，如下面的第二个示例所示

>>> filename = open('filename_in_mbcs.txt', 'rb').read()
>>> text = open(filename, 'r').read()

要更正此代码，应在读取文件时或使用该值之前指定 filename 中字节的编码

>>> # Fix 1: Open file as text (default encoding)
>>> filename = open('filename_in_mbcs.txt', 'r').read()
>>> text = open(filename, 'r').read()

>>> # Fix 2: Open file as text (explicit encoding)
>>> filename = open('filename_in_mbcs.txt', 'r', encoding='mbcs').read()
>>> text = open(filename, 'r').read()

>>> # Fix 3: Explicitly decode the path
>>> filename = open('filename_in_mbcs.txt', 'rb').read()
>>> text = open(filename.decode('mbcs'), 'r').read()

当 filename 的创建者与 filename 的用户分开时，编码是需要包含的重要信息

>>> some_object.filename = r'C:\Users\Steve\Documents\my_file.txt'.encode('mbcs')

>>> filename = some_object.filename
>>> type(filename)
<class 'bytes'>
>>> text = open(filename, 'r').read()

为了修复此代码以实现跨操作系统和 Python 版本的最佳兼容性，应将文件名公开为 str

>>> # Fix 1: Expose as str
>>> some_object.filename = r'C:\Users\Steve\Documents\my_file.txt'

>>> filename = some_object.filename
>>> type(filename)
<class 'str'>
>>> text = open(filename, 'r').read()

或者，需要将用于路径的编码提供给用户。指定 os.fsencode()（或 sys.getfilesystemencoding()）是一个可接受的选择，或者可以添加一个具有精确编码的新属性

>>> # Fix 2: Use fsencode
>>> some_object.filename = os.fsencode(r'C:\Users\Steve\Documents\my_file.txt')

>>> filename = some_object.filename
>>> type(filename)
<class 'bytes'>
>>> text = open(filename, 'r').read()


>>> # Fix 3: Expose as explicit encoding
>>> some_object.filename = r'C:\Users\Steve\Documents\my_file.txt'.encode('cp437')
>>> some_object.filename_encoding = 'cp437'

>>> filename = some_object.filename
>>> type(filename)
<class 'bytes'>
>>> filename = filename.decode(some_object.filename_encoding)
>>> type(filename)
<class 'str'>
>>> text = open(filename, 'r').read()

显式使用“mbcs”

在传递给文件系统 API 之前显式使用“mbcs”编码文本的代码现在正在传递编码错误的字节。请注意，在此示例中，filename 的来源无关紧要，前提是它是 str

>>> filename = open('files.txt', 'r').readline().rstrip()
>>> text = open(filename.encode('mbcs'), 'r')

要更正此代码，应在不进行显式编码的情况下传递字符串，或者应使用 os.fsencode()

>>> # Fix 1: Do not encode the string
>>> filename = open('files.txt', 'r').readline().rstrip()
>>> text = open(filename, 'r')

>>> # Fix 2: Use correct encoding
>>> filename = open('files.txt', 'r').readline().rstrip()
>>> text = open(os.fsencode(filename), 'r')