当函数中 return 语句后仍存在其他执行语句（如 print()），Python 解释器会直接退出函数，导致后续代码永远不会运行，Pylance 静态分析器因此提示“code is unreachable”。
当函数中 `return` 语句后仍存在其他执行语句（如 `print()`），python 解释器会直接退出函数，导致后续代码永远不会运行，pylance 静态分析器因此提示“code is unreachable”。
在数据处理脚本中，常见错误模式如下：
def save_test_data(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 unreachable该问题并非运行时错误，而是静态分析警告（由 Pylance、Pyright 等工具触发），但其背后反映的是逻辑缺陷：print() 永远不会被执行——因为 return df 已提前终止函数。
✅ 正确做法是将调试信息置于 return 之前，或使用日志记录：
def save_test_data(df, file_path):
df.to_csv(file_path, index=False, encoding="utf-8")
print(f"Test data saved to {file_path}") # ✅ 放在 return 前
return df或者更规范地使用 logging（推荐用于生产环境）：
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
立即学习“Python免费学习笔记（深入）”；
import logging
logging.basicConfig(level=logging.INFO)
def save_test_data(df, file_path):
df.to_csv(file_path, index=False, encoding="utf-8")
logging.info(f"Test data saved to {file_path}")
return df⚠️ 注意事项：
-
return是函数的立即退出点，其后所有语句（包括raise、print、赋值、甚至注释后的代码）均属不可达； - 即使
return后跟的是条件判断（如if False: print(...)），只要语法上位于return之后，Pylance 仍可能标记为不可达（取决于控制流分析深度）； - 若需在返回前做多步操作，建议按执行顺序组织代码，避免“先返回再通知”的反模式。
总结：该警告是代码逻辑清晰性的强信号。修复方式简单——调整语句顺序，确保所有副作用（如 I/O、日志、状态更新）都在 return 之前完成。养成“先完成操作，再返回结果”的编码习惯，可同时提升可读性与静态检查通过率。
