根本解法是将项目移至纯英文路径，因vs code调试器、python解释器及pylance均对中文路径支持不佳；需配合utf-8编码声明、pythonioencoding环境变量及integratedterminal设置确保中文正常显示与调试。
中文路径下Python文件无法运行或调试失败
VS Code 默认对含中文字符的路径支持不稳定，尤其在 launch.json 中使用 ${file} 或 ${workspaceRoot} 时，若路径含中文，调试器常报错 FileNotFoundError 或直接静默退出。这不是编码问题，而是底层进程启动时路径解析失败。
根本原因是 Python 解释器（尤其是 Windows 上的 python.exe）和 VS Code 调试适配器在传递带中文的绝对路径时未做 UTF-8 编码转义，导致子进程无法识别目标文件。
- 最可靠解法：把项目根目录移到纯英文路径下，例如
D:\code\myproject或/Users/name/pyproj - 临时规避（不推荐长期用）：在
launch.json中显式写死不含中文的绝对路径，如"program": "D:/code/test.py"，但每次换机器/用户都要改 - 不要依赖“系统区域设置”或修改控制台代码页（
chcp 65001），这无法修复调试器内部路径传递链路
调试时终端乱码、print输出中文变问号
这是终端编码与 Python 源文件声明不匹配的典型表现。VS Code 集成终端默认使用系统 locale，而 Python 文件若以 UTF-8 保存却没声明编码，Windows 下极易出乱码。
必须同时满足两个条件才能稳定显示中文：
- Python 源文件首行加编码声明：
# -*- coding: utf-8 -*-（或# coding=utf-8），放在第一行或第二行 - 确保终端本身支持 UTF-8：Windows 用户需确认 PowerShell 或 CMD 已设为 UTF-8（PowerShell 默认已是；CMD 可执行
chcp 65001，但该设置不持久） - 在
launch.json的配置中，添加"env": {"PYTHONIOENCODING": "utf-8"}，强制 Python I/O 使用 UTF-8
注意：console 字段设为 "externalTerminal" 后，VS Code 不再控制终端编码，此时必须靠系统终端自身配置，风险更高，建议优先用 "integratedTerminal"。
launch.json 中 console 设置影响中文输出行为
console 字段决定调试时 Python 进程的标准输出流向哪里，不同取值对中文处理差异明显：
-
"console": "integratedTerminal"：输出到 VS Code 底部集成终端，受 VS Code 自身字体和编码设置影响，配合PYTHONIOENCODING最稳定 -
"console": "externalTerminal"：调用系统终端（如 Windows Terminal、iTerm2），输出是否正常完全取决于该终端当前编码和字体——即使你改了 VS Code 设置也无效 -
"console": "none"：无终端窗口，所有输出进调试控制台（Debug Console），它原生支持 UTF-8，中文最可靠，但无法交互式输入
如果你的脚本需要 input()，又必须显示中文，选 integratedTerminal + PYTHONIOENCODING 是唯一兼顾可用性与稳定性的组合。
中文项目名/文件名导致 Pylance 补全失效或 import 报错
Pylance（微软官方语言服务器）对非 ASCII 文件名的支持存在已知限制。当 import 语句引用一个含中文名的模块（如 import 爬虫工具），或项目文件夹名为中文时，Pylance 往往无法解析路径，导致补全丢失、跳转失败、甚至标红 ImportError。
这不是 bug，而是设计约束：Python 标准导入机制本身允许中文模块名（需文件名是合法标识符且源码声明 UTF-8），但语言服务器为性能和兼容性，默认只索引 ASCII 路径。
- 真实可运行 ≠ IDE 能识别：你的代码可能实际能跑通，但编辑器就是不给提示
- 解决方式只有两种：重命名文件/文件夹为纯英文（推荐），或在
settings.json中关闭 Pylance 的路径校验（不推荐，会牺牲大量功能） - 不要试图用
__import__()或动态字符串导入来“绕过”，这只会让类型推导更糟
路径里有中文不是“小问题”，它是整个工具链（解释器、调试器、语言服务器、包管理器）协同失效的触发点。与其花时间调参，不如从新建项目那一刻起就用英文命名。这是目前最省力、最可持续的做法。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
