Jupyter Notebook中使用argparse报错：unrecognized arguments: -f求解

这绝对是Jupyter和argparse搭配时的经典坑！原因很简单：当你在Notebook里运行代码时，Jupyter内核启动器ipykernel_launcher.py会自动给你的代码传递一个-f参数（用来指定内核的JSON配置文件），但你的argparse parser根本没定义这个参数，所以执行parse_args()时就会抛出"unrecognized arguments: -f"的错误。

下面给你几个简单好用的解决方案，按便捷程度排序：

1. 直接给parse_args传递空参数列表（最快最省事） #

如果你只是在Notebook里测试代码，不需要传递命令行参数，直接让argparse忽略所有自动传入的参数就行：

import argparse

parser = argparse.ArgumentParser()
parser.add_argument('--lr', default=0.1, type=float, help='learning rate')
parser.add_argument('--resume', '-r', action='store_true', help='resume from checkpoint')

# 关键修改：传递空列表，跳过Notebook自动加的-f参数
args = parser.parse_args([])

# 测试一下效果
print(f"Learning rate: {args.lr}")
print(f"Resume from checkpoint: {args.resume}")

如果需要测试指定参数（比如想试--lr 0.01和--resume），直接把参数写在列表里：

args = parser.parse_args(['--lr', '0.01', '-r'])

2. 给parser添加对-f参数的支持（兼容脚本和Notebook） #

如果你的代码需要同时在普通Python脚本和Notebook里运行，可以给parser加一个-f参数的定义，让它忽略这个参数就行：

import argparse

parser = argparse.ArgumentParser()
parser.add_argument('--lr', default=0.1, type=float, help='learning rate')
parser.add_argument('--resume', '-r', action='store_true', help='resume from checkpoint')
# 添加这一行，让parser识别Jupyter自动传递的-f参数
parser.add_argument('-f', '--file', help='Jupyter kernel config file (ignore this)', required=False)

args = parser.parse_args()

这样不管是在脚本里用python your_script.py --lr 0.01 -r运行，还是在Notebook里运行，都不会报错。

3. 自动检测运行环境（最优雅的方式） #

可以通过判断当前运行的脚本名称，自动决定怎么处理argparse：

import argparse
import sys

parser = argparse.ArgumentParser()
parser.add_argument('--lr', default=0.1, type=float, help='learning rate')
parser.add_argument('--resume', '-r', action='store_true', help='resume from checkpoint')

# 判断是否在Jupyter环境中
if 'ipykernel_launcher.py' in sys.argv[0]:
    # 在Notebook里，忽略自动参数
    args = parser.parse_args([])
else:
    # 在普通脚本里，正常解析参数
    args = parser.parse_args()

这种方式完全不需要手动修改代码的运行方式，代码会自动适配环境。

内容的提问来源于stack exchange，提问作者nolwww