在 Python 函数中，return 语句会立即终止函数执行并返回控制权，其后的所有代码（包括 print、赋值、文件操作等）均不会运行，Pylance 会标记为“unreachable”警告。
在 python 函数中，`return` 语句会立即终止函数执行并返回控制权，其后的所有代码（包括 `print`、赋值、文件操作等）均不会运行，pylance 会标记为“unreachable”警告。
这是一个常见但容易被忽视的控制流陷阱。当你写出如下代码时：
def save_and_return(df, file_path):
df.to_csv(file_path, index=False, encoding="utf-8")
return df
print(f"Test data saved to {file_path}") # ❌ Pylance 报错：Code is unreachableprint() 语句位于 return 之后，永远无法执行——因为函数在 return df 执行完毕后即退出，后续语句被 Python 解释器跳过，Pylance（VS Code 的智能语言服务器）据此静态分析出该行“不可达”，并发出提示。
✅ 正确做法是：将调试信息置于 return 之前，或使用日志/注释替代：
def save_and_return(df, file_path):
df.to_csv(file_path, index=False, encoding="utf-8")
print(f"Test data saved to {file_path}") # ✅ 放在 return 前
return df⚠️ 注意事项：
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
立即学习“Python免费学习笔记（深入）”；
-
return是函数的终点，不是“暂停点”；即使return后无其他逻辑，也不建议留空行或注释误导可读性； - 若需在返回前做多步操作（如保存、记录、验证），应严格按执行顺序组织；
- 在 Jupyter 或脚本中单独执行
print()（不在函数内）不会触发此警告——该问题仅出现在函数作用域内； - 使用
logging.info()替代print()更符合生产环境规范，且便于开关控制。
? 小技巧：若想快速验证某行是否可达，可在该行前加 assert False，运行时若未报 AssertionError，说明它确实未被执行——这是调试不可达代码的有效手段。
总之，遵循“先操作、后返回”的原则，保持控制流清晰，即可彻底避免此类 Pylance 警告，并提升代码健壮性与可维护性。
