Codex 在 Windows 中文路径执行bash命令编码问题复盘

Codex 在 Windows 中文路径执行bash命令编码问题复盘

问题现象

在 Windows 环境下处理中文路径、中文文件名、中文 Markdown/PPT 等文件时,旧版 Windows PowerShell 中可能出现:

  • 中文文件名或路径在 Python 中变成 ????
  • Get-Content 或命令输出出现中文乱码
  • 明明文件存在,但脚本中 Path.exists() 返回 False
  • PPT、draw.io、Office、Python 脚本因路径被错误转码而找不到文件

脱敏示例:

text 复制代码
<项目目录>\ppt\<中文文件名>.pptx
<项目目录>\ppt\<中文文件名>v2.md

根因

主要原因是 Windows PowerShell 5.1 在中文内容经过 heredoc、管道、子进程参数传递时,编码边界不稳定。中文路径在进入 Python 或其他工具前可能已经被替换成 ????。这通常不是源文件损坏,而是 shell 编码/传参问题。

已验证环境

text 复制代码
Windows PowerShell: 5.1.26100.4768
PowerShell 7:      7.6.1
Python:            3.13.5
pwsh path:         C:\Program Files\PowerShell\7\pwsh.exe

PowerShell 7 当前编码:

text 复制代码
Console OutputEncoding: UTF-8
PowerShell OutputEncoding: UTF-8

Windows PowerShell 5.1 当前状态:

text 复制代码
Console OutputEncoding: UTF-8
PowerShell OutputEncoding: US-ASCII

解决方法

优先使用PowerShell 7

powershell 复制代码
pwsh -NoLogo -NoProfile -Command "<command>"

检查:

powershell 复制代码
where.exe pwsh
pwsh -NoLogo -NoProfile -Command '$PSVersionTable.PSVersion; [Console]::OutputEncoding.EncodingName; $OutputEncoding.EncodingName'

涉及中文路径时,即使在 PowerShell 7 下,也优先让 Python 从文件系统枚举真实路径:

python 复制代码
from pathlib import Path

p = next(Path("ppt").glob("*v2.md"))
text = p.read_text(encoding="utf-8")

避免在旧 PowerShell heredoc 或命令参数中直接硬写中文路径。

后续准则

  • 中文路径/中文文件优先用 pwsh,避免 Windows PowerShell 5.1。
  • 文本读写显式指定 encoding="utf-8"
  • 中文文件名优先用 Path.glob() / Path.iterdir() 获取真实路径。
  • 遇到 ???? 时,先判断是终端编码/传参问题,不要直接改源文件。

来源

codex生成

相关推荐
维度攻城狮17 小时前
在Vscode连接的Docker容器中使用codex,并配置DeepSeek模型
vscode·docker·codex
逐梦苍穹1 天前
我开源了一个Claude Code历史可视化工具:本地Prompt一键浏览、搜索、导出
人工智能·开源·prompt·codex·claudecode
sg_knight2 天前
openCode、Claude Code、Cursor、Copilot,到底怎么选
llm·agent·ai编程·claude·codex·opencode·claude-code
夏白分享社2 天前
Codex 客户端下载与安装教程:通过网盘下载解决问题
ai·agent·codex
豆奶豆豆奶3 天前
Ubuntu 中 Codex CLI 登录失败:使用 OpenAI API Key 解决
ubuntu·codex
养肥胖虎4 天前
多Agent开发笔记:为什么4个Codex加1个Claude会把cpu跑满
vscode·agent·codex
人道领域4 天前
一篇文章解决Codex的安装,实操一遍过
java·开发语言·codex
BestOrNothing_20155 天前
Codex Skill 保姆级教程 1:Computer Use — 让 AI 接管整台电脑
codex·ai编程助手·computer use·chatgpt5.5·电脑操控
程序员佳佳6 天前
深度解析:向量引擎如何影响AI内容收录?附3个月实测数据
人工智能·gpt·自动化·ai写作·codex
一行16 天前
Codex CLI 全平台安装步骤
人工智能·ai·codex·问鼎ai